本文收录于 《全栈 Bug 调优实战版》 专栏。专栏聚焦真实项目中的各类疑难 Bug从成因剖析 → 排查路径 → 解决方案 → 预防优化全链路拆解形成一套可复用、可沉淀的实战知识体系。无论你是初入职场的开发者还是负责复杂项目的资深工程师都可以在这里构建一套属于自己的「问题诊断与性能调优」方法论助你稳步进阶、放大技术价值。特别说明文中问题案例来源于真实生产环境与公开技术社区并结合多位一线资深工程师与架构师的长期实践经验经过人工筛选与AI系统化智能整理后输出。文中的解决方案并非唯一“标准答案”而是兼顾可行性、可复现性与思路启发性的实践参考供你在实际项目中灵活运用与演进。欢迎订阅本专栏一次订阅后专栏内所有文章可永久免费阅读后续更新内容皆不用再次订阅持续更新中。 问题描述详细问题描述如下安装comfyui之后无法打开这是什么问题提示报错TypeError: ‘NoneType’ object is not iterableTypeError: ‘NoneType’ object is not iterable…如何解决全文目录 问题描述 请知悉如下方案不保证一定适配你的问题✅️问题理解你的额外模型路径配置文件有问题✅️问题解决方案方案 A直接删除或禁用 extra_model_paths.yaml最推荐最快恢复操作步骤为什么这样能解决最适合这种方案的人你可以直接这样排查方案 B把 extra_model_paths.yaml 修成合法 YAML适合你确实要共享外部模型目录先给你一个最小可用修复法这是重点正确示例 1最小合法空配置正确示例 2共享 A1111 模型目录正确示例 3你有独立模型总目录YAML 修复注意点推荐的检查方式方案 C用官方示例文件重新生成配置适合你怀疑现有 YAML 被改坏了推荐做法为什么这招靠谱方案 D直接修 ComfyUI 源码做防御判断高级方案能治标也比较稳大致思路这样改的意义这个方案的优缺点什么时候建议用这个方案方案 E重新解压/重新安装 ComfyUI兜底方案不是第一选择正确恢复顺序建议为什么不建议一上来就重装✅️问题延伸1. 为什么“空文件”会导致 NoneType is not iterable2. 为什么不是显卡、Torch、CUDA 的锅3. 为什么不是 custom_nodes 的首要问题4. 为什么“只有注释”的 YAML 也可能触发这个错误✅️问题预测预测 1ComfyUI 能启动了但模型列表是空的预测 2启动后提示某些 custom_nodes 缺依赖预测 3你改成 {} 后能启动但共享模型失效预测 4你手改源码后更新 ComfyUI 又复发预测 5Windows 记事本保存方式导致二次问题✅️小结你现在最应该先做的事第一轮最简修复第二轮修复 结语 互动说明 文末福利技术成长加速包 Who am I? 请知悉如下方案不保证一定适配你的问题如下是针对上述问题进行专业角度剖析答疑不喜勿喷仅供参考✅️问题理解你这个报错不是 ComfyUI 主程序本体坏了也不是 Python 环境直接炸了更不是模型文件缺失导致的。从你截图里的调用栈看问题发生在ComfyUI 启动早期读取“额外模型路径配置”时apply_custom_paths()-utils.extra_config.load_extra_path_config(extra_model_paths_config_path)-forcinconfig:TypeError:NoneTypeobjectisnotiterable这段报错的核心含义是程序本来期望config是一个可迭代对象比如字典dict列表list结果实际拿到的是None然后程序执行for c in config:时就直接崩了结合 ComfyUI 的启动逻辑这个错误高概率说明ComfyUI 读取到的extra_model_paths.yaml或你指定的额外模型路径配置文件是空的、只有注释、内容被清空了或者 YAML 被解析成了None。也就是说最可能的问题不是“安装失败”而是你的额外模型路径配置文件有问题最常见的几种真实情况extra_model_paths.yaml是空文件文件里只有注释没有真正的 YAML 数据文件内容是null或~这种 YAML 也会被解析成None你把extra_model_paths.yaml.example改名成了extra_model_paths.yaml但内容没配好某些编辑器保存后把文件内容弄没了导致虽然文件存在但实际是“空配置”你这个问题从报错路径可以进一步判断报错发生在ComfyUI\utils\extra_config.py也就是ComfyUI 还没正式进入模型加载、节点加载、显卡初始化阶段所以这不是 CUDA、Torch、显卡驱动、custom_nodes 的第一优先级问题第一优先级就是检查extra_model_paths.yaml下面是这个问题的逻辑流程图你可以对照理解一下 ✅️问题解决方案方案 A直接删除或禁用extra_model_paths.yaml最推荐最快恢复如果你没有共享其他 WebUI 的模型目录、也没有特别配置外部模型路径那么最简单、最稳的方式就是把extra_model_paths.yaml去掉让 ComfyUI 不读取它。这是最常见、最有效的修复方式。很多人安装后无法启动最后就是这里卡住。操作步骤进入你的 ComfyUI 根目录从截图看是E:\ComfyUI_windows\找下面这些文件extra_model_paths.yaml extra_model_paths.yaml.example如果存在extra_model_paths.yaml先不要删先改名备份extra_model_paths.yaml.bak然后重新启动 ComfyUI为什么这样能解决ComfyUI 启动时会尝试读取额外模型路径配置。如果这个文件不存在通常程序会直接跳过这一步但如果这个文件存在且内容为空它就会读到None从而崩掉。所以文件不存在→ 通常没事文件存在但内容无效/为空→ 报你这个错最适合这种方案的人刚安装完 ComfyUI还没做模型共享配置不清楚extra_model_paths.yaml是干什么的只是想让 ComfyUI 先正常启动你可以直接这样排查在 CMD 里执行dir E:\ComfyUI_windows\extra_model_paths*如果看到了extra_model_paths.yaml那就基本命中了。方案 B把extra_model_paths.yaml修成合法 YAML适合你确实要共享外部模型目录如果你确实需要这个文件比如你想让 ComfyUI 复用 A1111 / Forge / WebUI 的模型你有单独的模型仓库目录你不想复制模型想直接映射路径那就不要删文件而是把它修成合法 YAML。先给你一个最小可用修复法如果你暂时不确定要填什么但又不想删掉文件直接把文件内容改成{}这表示“空字典”是合法 YAML。程序读取后不会得到None也就不会在for c in config:这里报错。这是重点下面这几种内容都有问题# only commentsnull~这些都会导致 YAML 解析结果不是你想要的配置对象。正确示例 1最小合法空配置{}如果你只是为了让程序别崩这个就足够。正确示例 2共享 A1111 模型目录假设你的 A1111 在D:\stable-diffusion-webui那么可以写成a1111:base_path:D:/stable-diffusion-webuicheckpoints:models/Stable-diffusionconfigs:models/Stable-diffusionvae:models/VAEloras:models/Loraembeddings:embeddingscontrolnet:extensions/sd-webui-controlnet/models正确示例 3你有独立模型总目录假设你自己统一放在D:\AI\Models可以写成类似my_models:base_path:D:/AI/Modelscheckpoints:checkpointsvae:vaeloras:lorasembeddings:embeddingscontrolnet:controlnetupscale_models:upscale_modelsYAML 修复注意点这个地方非常重要很多人会修着修着又坏掉缩进必须用空格不要用 Tab路径最好写成D:/AI/Models或D:\\AI\\Models不要写成不规范的层级保存编码建议用UTF-8文件不要只剩下注释:后面要有空格例如base_path:D:/AI/Models推荐的检查方式你可以先用记事本打开extra_model_paths.yaml看看是不是以下情况之一文件一片空白只有几行# 注释只写了一个冒号结构但不完整内容像复制残了如果是先直接替换成{}然后再启动一次。方案 C用官方示例文件重新生成配置适合你怀疑现有 YAML 被改坏了很多 ComfyUI 安装包里都会带一个类似extra_model_paths.yaml.example这个文件通常是示例模板。如果你怀疑当前的extra_model_paths.yaml被改坏了最稳妥的方式是删除或备份现有的extra_model_paths.yaml找到extra_model_paths.yaml.example复制一份出来改名为extra_model_paths.yaml再按模板填写你的路径推荐做法如果你不需要额外模型路径根本不要创建extra_model_paths.yaml如果你需要额外模型路径从.example模板复制而不是自己凭空写为什么这招靠谱因为很多用户是自己新建了一个空的extra_model_paths.yaml或者把.example改名后把内容删了结果就触发了这个问题。方案 D直接修 ComfyUI 源码做防御判断高级方案能治标也比较稳如果你希望即便 YAML 是空的程序也不要崩可以在源码里加一个判空保护。这个方案适合有 Python 基础的人。它不是首选但在某些场景下非常实用。大致思路打开这个文件E:\ComfyUI_windows\ComfyUI\utils\extra_config.py找到类似configyaml.safe_load(f)forcinconfig:...把它改成类似这样configyaml.safe_load(f)ifnotconfig:returnforcinconfig:...或者更稳一点configyaml.safe_load(f)ifconfigisNone:returnforcinconfig:...这样改的意义即使文件是空的yaml.safe_load(f)返回None程序直接return不会再执行for c in configComfyUI 可以继续启动这个方案的优缺点优点彻底避免这个空配置崩溃点容错性更强对开发者/高级用户很友好缺点更新 ComfyUI 后可能被覆盖它只是防御不代表你的配置是对的如果 YAML 真有路径需求这样只是“跳过读取”不是“修好配置”什么时候建议用这个方案你会改 Python 源码你想提高 ComfyUI 的容错性你确认这就是空配置导致的报错你不介意后续更新时重新改一次方案 E重新解压/重新安装 ComfyUI兜底方案不是第一选择如果你已经改过很多文件不确定改乱了哪些配置extra_model_paths.yaml、批处理文件、custom_nodes、Python 包都动过现在环境很脏难以判断那就建议备份模型目录备份自定义节点目录重新下载/重新解压一个干净版 ComfyUI先不放extra_model_paths.yaml先确认能正常启动再逐步恢复模型和节点正确恢复顺序建议为什么不建议一上来就重装因为从你这个报错看问题非常聚焦大概率只是一份 YAML 文件空了。这种问题通常 13 分钟就能修好没必要一上来全盘重装。✅️问题延伸这个问题很有代表性我顺便帮你把它背后的原理讲透这样你以后排查同类 Python/配置问题会快很多。1. 为什么“空文件”会导致NoneType is not iterable因为很多 YAML 解析器的行为是这样的yaml.safe_load()返回的不是{}而是None程序作者如果默认以为配置文件一定有内容然后直接forcinconfig:就会崩。也就是说空配置文件 ≠ 空字典在 Python/YAML 语义里空文件更接近“没有值”也就是None2. 为什么不是显卡、Torch、CUDA 的锅因为你的报错链路非常早还在apply_custom_paths()还没开始真正加载模型还没走到推理阶段还没走到 GPU 初始化的关键部分所以这和下面这些基本没直接关系CUDA 版本不匹配显卡驱动问题Torch 安装问题xformers 问题checkpoint 文件损坏这些问题通常会出现完全不同的报错特征。3. 为什么不是 custom_nodes 的首要问题custom_nodes的问题通常报错会更像ImportErrorModuleNotFoundError某节点加载失败pip 依赖缺失某个扩展执行报错而你这里是主程序在读取启动配置路径时就挂了说明节点系统大概率还没真正开始处理所以排查顺序要对先看配置文件再看扩展再看模型再看环境。4. 为什么“只有注释”的 YAML 也可能触发这个错误例如# checkpoints path# loras path# vae path看起来像“有内容”但对 YAML 解析器来说这依然可能等于没有实际数据最终仍可能得到None。所以不要被“文件不是空白”误导。只要没有真正的 YAML 数据结构它就可能仍然是None。✅️问题预测修完这一步之后后续你可能还会碰到下面这些情况我提前帮你预判一下预测 1ComfyUI 能启动了但模型列表是空的这通常说明你删除了extra_model_paths.yaml但你的模型原来是放在外部 WebUI 路径里ComfyUI 自己默认目录中没有模型这不是启动失败而是路径映射没配。解决办法要么把模型复制到 ComfyUI 默认模型目录要么把extra_model_paths.yaml配正确预测 2启动后提示某些 custom_nodes 缺依赖这属于第二阶段问题和你当前这个不是一类。常见表现某个节点无法导入缺第三方库pip 安装失败这时候就应该去看custom_nodes的依赖安装而不是再纠结 YAML。预测 3你改成{}后能启动但共享模型失效这完全正常。因为{}只是让配置文件合法不代表它已经配置了共享路径。所以{} 防止程序崩正式路径配置 还得你按目录实际填写预测 4你手改源码后更新 ComfyUI 又复发如果你走的是“修改extra_config.py”这条路那么更新版本时源码可能会被覆盖。届时你可能又看到类似错误。所以从长期来看真正的根治还是把 YAML 文件修好源码防御只是兜底。预测 5Windows 记事本保存方式导致二次问题有些编辑器会保存成奇怪编码加 BOM自动替换缩进搞乱换行虽然不一定触发你这次这个错误但确实会增加 YAML 出错概率。建议用 VS Code / Notepad 编辑保存为 UTF-8缩进用空格✅️小结你这个问题的本质可以一句话概括ComfyUI 在启动时读取extra_model_paths.yaml时读到了一个“空配置”并被解析成None随后在遍历时触发了TypeError: NoneType object is not iterable。最推荐你的实际处理顺序是到E:\ComfyUI_windows\下检查有没有extra_model_paths.yaml如果有先改名备份extra_model_paths.yaml.bak重新启动 ComfyUI如果你确实需要额外模型路径再新建合法 YAML最简单的合法内容先写{}你现在最应该先做的事直接按这个顺序来E:\ComfyUI_windows\ ├─ extra_model_paths.yaml ← 如果有它先改名 ├─ extra_model_paths.yaml.example ├─ ComfyUI\ └─ python_embeded\第一轮最简修复把extra_model_paths.yaml改名为extra_model_paths.yaml.bak再启动一次第二轮修复如果你确实需要这个文件就把内容改成{}再启动。 结语 互动说明希望以上分析与解决思路能为你当前的问题提供一些有效线索或直接可用的操作路径。若你按文中步骤执行后仍未解决不必焦虑或抱怨这很常见——复杂问题往往由多重因素叠加引起欢迎你将最新报错信息、关键代码片段、环境说明等补充到评论区我会在力所能及的范围内结合大家的反馈一起帮你继续定位 如果你有更优或更通用的解法非常欢迎在评论区分享你的实践经验或改进方案你的这份补充可能正好帮到更多正在被类似问题困扰的同学正所谓「赠人玫瑰手有余香」也算是为技术社区持续注入正向循环 文末福利技术成长加速包 文中部分问题来自本人项目实践部分来自读者反馈与公开社区案例也有少量经由全网社区与智能问答平台整理而来。若你尝试后仍没完全解决问题还请多一点理解、少一点苛责——技术问题本就复杂多变没有任何人能给出对所有场景都 100% 套用的方案。如果你已经找到更适合自己项目现场的做法非常建议你沉淀成文档或教程这不仅是对他人的帮助更是对自己认知的再升级。如果你还在持续查 Bug、找方案可以顺便逛逛我专门整理的 Bug 专栏《全栈 Bug 调优实战版》️这里收录的都是在真实场景中踩过的坑希望能帮你少走弯路节省更多宝贵时间。✍️如果这篇文章对你有一点点帮助欢迎给 bug菌 来个一键三连关注 点赞 收藏你的支持是我持续输出高质量实战内容的最大动力。同时也欢迎关注我的硬核公众号 「猿圈奇妙屋」获取第一时间更新的技术干货、BAT 等互联网公司最新面试真题、4000G 技术 PDF 电子书、简历 / PPT 模板、技术文章 Markdown 模板等资料通通免费领取。你能想到的绝大部分学习资料我都尽量帮你准备齐全剩下的只需要你愿意迈出那一步来拿。 Who am I?我是 bug菌热活跃于 CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等技术社区CSDN 博客之星 Top30、华为云多年度十佳博主/卓越贡献者、掘金多年度人气作者 Top40掘金、InfoQ、51CTO 等平台签约及优质作者全网粉丝累计30w。更多高质量技术内容及成长资料可查看这个合集入口 点击查看 ️硬核技术公众号「猿圈奇妙屋」期待你的加入一起进阶、一起打怪升级。- End -