TypeError: ‘NoneType’ object is not iterable

快速结论：这个 TypeError: 'NoneType' object is not iterable 通常出现在 Stable Diffusion WebUI Forge 处理生成请求时，某个后端函数返回了 None，而调用方却按可迭代对象（list(...)）去处理。优先排查最近改动过的扩展、脚本或生成参数组合。

适用环境：Issue 中确认的环境为 Windows（路径为 C:\Users\Stepan\Downloads\webui_forge_cu121_torch231），使用 webui_forge_cu121_torch231 整合包。其余 Python、CUDA、PyTorch、显卡、依赖版本在 Issue 中未明确给出，不做补写。

最快修复方案：暂无确认的一步修复方案。Issue 中报告者仅表示“已修复该错误”，但未说明具体修复方法。

注意事项：报告者修复该错误后又遇到了新问题，因此该报错可能只是配置或扩展链中的一环，不一定代表整体环境已恢复。不要直接照搬未经证实的命令或版本号。

问题场景

用户在 Stable Diffusion WebUI Forge 中提交生成请求（请求参数中包含 ControlNet 单元、Refiner、高分辨率修复、分块/平铺相关参数等）时，任务进入 call_queue 后失败，界面提示 “Error completing request”。从参数看，请求同时携带了多个 ControlNetUnit、Refiner 设置、脚本参数以及采样参数，属于较复杂的生成配置。

报错原文

Error completing request
*** Arguments: ('task(rz36hruay0xiraq)', , 0, '', '', [], , None, ... ) {}
    Traceback (most recent call last):
      File "C:\Users\Stepan\Downloads\webui_forge_cu121_torch231\webui\modules\call_queue.py", line 74, in f
        res = list(func(*args, **kwargs))
    TypeError: 'NoneType' object is not iterable

原因分析

从 traceback 看，报错发生在 modules/call_queue.py 第 74 行，代码执行 res = list(func(*args, **kwargs)) 时，func(...) 返回了 None，而 list(None) 会直接抛出 TypeError: 'NoneType' object is not iterable。

可能原因包括：

某个被调用的生成函数或扩展脚本在特定参数组合下提前返回了 None，没有返回预期的可迭代结果。
某个扩展（例如 ControlNet、Refiner 或脚本类扩展）与当前 Forge 版本不兼容，导致后端函数异常返回。
复杂的参数组合（多个 ControlNet 单元、Refiner、高分辨率修复、平铺/分块等）触发了某条未覆盖的代码路径。
依赖或环境不完整，导致某个函数未能正常执行并返回 None。

Issue 评论中报告者称“I fixed that error”，但未说明具体修复动作，因此上述原因中哪一项是最终根因，无法从现有讨论确认。

环境排查

确认使用的 Forge 整合包版本，路径中显示为 webui_forge_cu121_torch231。
确认 Python、PyTorch、CUDA 版本与整合包标注是否一致（Issue 中未给出具体版本号）。
确认显卡型号与显存是否足以支撑当前参数（如 1152×896、多个 ControlNet 单元、Refiner 等）。
确认已启用哪些扩展，尤其是 ControlNet、Refiner、脚本类扩展，以及它们是否与当前 Forge 版本兼容。
确认最近是否更新过扩展、模型或整合包，导致行为发生变化。

解决步骤

先减少变量：关闭或禁用所有非必要的扩展（尤其是 ControlNet、Refiner 及脚本类扩展），只保留最基础的文生图流程，重新提交请求，观察是否仍报同样错误。
逐步恢复参数：从简单提示词、默认采样参数开始，逐个加回 ControlNet 单元、Refiner、高分辨率修复、平铺/分块等参数，定位是哪一个参数组合触发报错。
检查扩展兼容性：若某个扩展启用后必现报错，尝试将其更新到与当前 Forge 版本匹配的版本；若更新后仍报错，可暂时禁用该扩展。
查看控制台完整日志：除了界面上的 traceback，还要查看启动 Forge 的终端窗口输出，确认在 call_queue.py 第 74 行之前是否有更具体的异常信息。
若以上步骤都无法定位，可重启 Forge 并重新加载默认设置后重试，排除临时状态异常。

注意：Issue 中报告者并未公布具体修复步骤，以上为基于 traceback 的排查方向，属于可优先尝试的步骤，不代表已验证的官方修复方案。

验证方法

重新提交与报错时相同或相近的生成请求，观察是否还会出现 TypeError: 'NoneType' object is not iterable。如果任务能正常进入采样并输出图像，且终端不再出现该 traceback，说明问题已绕过或解决。若仍出现相同报错，请按“解决步骤”继续缩小参数或扩展范围。