报错排查
把日志变成可查阅的文章。
粘贴报错原文,或输入你看到的现象。匹配在浏览器内完成,不上传日志、不执行修复。
浏览器内匹配 · 不写入网址、浏览器存储或分析事件。离开本页或清空后,不保留输入;导出只包含文章指针。第三方浏览器扩展不在本站控制范围内。
这里只检索文章,不检查你的 Python、模型或 GPU;排列顺序不是诊断结论或修复成功率。
按分类浏览
或者按分类浏览排查文章
当前语言已发布的全部报错文章,按问题类型分组。展开分组即可查看文章列表。
安装、环境与设备18 篇
- 采样完成后 VAE 解码爆显存:把解码负载单独检查
- 参数超范围或类型错误:先读节点允许值,再改数字
- 启动器被 Windows 拦截:先核对来源和告警,不要整目录加白名单
- Bad linked input:API 连线必须表达节点 ID 与输出槽
- ComfyUI 压缩包解不开:先判断压缩包损坏,还是目标目录不能写
- CUDA out of memory:按加载、采样和解码阶段排查显存
- Hugging Face 401 / 403:浏览器能看不等于下载程序已获授权
- Mac 的 MPS backend out of memory:先看统一内存压力
- MPS 不支持 Float8:区分权重格式与实际计算类型
- No space left on device:区分模型、临时目录与输出盘
- Prompt has no outputs:工作流里需要真正的输出终点
- Required input is missing:定位缺失输入,而不是反复点运行
- Return type mismatch:检查连线插槽,不要只看节点颜色
- Torch not compiled with CUDA enabled:不要先重装显卡驱动
- torch.cuda.is_available() 为 False:构建、驱动和容器逐层检查
- Windows 错误 1455:分页文件过小不等于显存不足
- Windows 提示路径过长:缩短目录和启用长路径并不是同一个修复
- xFormers 已安装却不可用:检查扩展构建与实际解释器
缺包、节点与版本冲突50 篇
- 缺少 OpenGL_accelerate:别把 Python 加速包当成显卡驱动修复
- 提示缺少 hydra,先核对 hydra-core;配置文件找不到是另一条排查路线
- 提示缺少 yaml、PIL 或 pydantic_settings:先核对包名,不要照抄报错安装
- aiohttp、requests 找不到与网络连不上,不是一种报错
- argostranslate 找不到,和“没有可用语言对”要分开处理
- blend_modes 能导入却混合失败:检查通道、数值范围和透明度
- CERTIFICATE_VERIFY_FAILED:安装依赖时怎样修复证书问题
- ComfyUI 导入后缺少节点:区分未安装、未注册和加载失败
- ComfyUI Manager 按钮不见了:新版入口与加载失败怎么区分
- Custom validation failed:继续读取节点自己的错误详情
- cv2 找不到或导入失败:先分清 OpenCV 四种安装包
- decord 能读视频但不能用 GPU:先分清 CPU 发行包和 GPU 构建
- deepdiff 报错:安装问题、对象比较和结果序列化分开看
- dlib 安装失败:Python 包、CMake 编译和模型资源分别排查
- DLL load failed:定位原生扩展,不要下载散装 DLL 覆盖系统
- FaceID 的 InsightFace 安装失败:分开检查 Python 依赖与模型资源
- flash_attn 安装失败:先确认 FlashAttention 代际、平台和编译条件
- ImportError: cannot import name:更新后接口不兼容怎么查
- Kornia 导入失败:主包、Torch 和可选依赖要分开看
- llama_cpp 缺失、编译失败和 GGUF 加载失败,应分三条路排查
- Manager 找不到 Git:先检查可执行文件与实例环境
- MediaPipe 与 NumPy 冲突:版本范围限制和二进制导入错误不能混为一谈
- MMCV 安装失败或缺少算子:先核对构建组合
- ModuleNotFoundError:包已安装,ComfyUI 仍说找不到模块
- No matching distribution found:Python、平台还是包源不对
- NumPy 版本不兼容:_ARRAY_API 与 dtype size changed
- Nunchaku 装好了还报错:把节点、Python 库和模型权重分别核对
- nvvfx 缺失:先确认节点使用的封装,别把模块名直接当 PyPI 包名
- ONNX 能导入但用不上显卡:分开查包、执行提供程序和会话
- pip ResolutionImpossible:两个节点的依赖冲突怎么处理
- Protobuf 报 Descriptors cannot be created directly:先找生成代码的归属
- pytorch_lightning 与 lightning 找不到:先按节点实际导入的路径选依赖
- Qwen Image 2.1 缺节点:核心没更新、前端落后与子图 UUID 分开查
- Qwen TTS 与 Transformers 冲突:先读取实际版本约束,不给整套 ComfyUI 统一降级
- rotary_embedding_torch 缺失,和旋转位置编码维度不匹配要分开处理
- safetensors 模块缺失还是权重文件无法读取?先分阶段排查
- SageAttention / Triton 导入失败:先核对平台与版本组合
- SAM、GroundingDINO 加载失败:代码、权重和原生扩展分开检查
- SciPy、einops、torchsde 报错:区分包缺失与运算本身失败
- SenseVoice-ONNX 提示 setuptools 冲突:先分清旧发行包和当前源码
- simpleeval 报错:缺模块和表达式写错要分别处理
- soundfile 报错:缺 Python 包、缺 libsndfile 和音频格式错误分开查
- Spandrel 已安装仍打不开模型:先查支持的架构
- SQLAlchemy、Alembic 导入或迁移失败:先保住本地数据
- This action is not allowed:Manager 安全级别阻止操作
- timm 找不到,和模型名称不支持、预训练权重下不来是三件事
- TorchScale 与 timm 冲突:消费方的精确锁定不能被“升级最新版”自动解决
- Transformers 缺包、找不到类、模型下载失败:不要混着修
- webcolors 已安装却找不到 CSS3_HEX_TO_NAMES:这是接口变化,不一定是缺包
- Windows Overlapped Object:Manager 启动时异步事件循环错误
模型、文件与工作流16 篇
- 拖入图片没有恢复工作流:先确认文件保留了元数据
- CLIP input is invalid: None:加载的 checkpoint 可能没有文本编码器
- CLIP Vision 找不到或不兼容:它不是提示词用的文本 CLIP
- ControlNet 报错或不起作用:核对底模、控制图和应用节点
- Dependency cycle detected:查找工作流中的循环依赖
- Expected all tensors to be on the same device:查 CPU 与 GPU 的交界
- Float / Half / BFloat16 不一致:沿调用栈定位失败运算
- GGUF 文件无法加载:容器格式相同不代表模型用途相同
- IPAdapter 模型找不到:统一加载器与手动加载器的命名规则不同
- LoRA 不生效或形状不匹配:先核对底模,再检查两条加载分支
- mat1 and mat2 shapes cannot be multiplied:按模型链路查维度
- Node has no class_type:区分错误导出与真正缺少节点
- Qwen Image 2.1 张量不匹配或解码失败:先核对三组件
- Safetensors 头部错误:核对下载完整性,不要只靠改后缀
- VAE / latent 通道不匹配:同名家族也要核对具体变体
- Value not in list:模型已经下载,为什么下拉框仍找不到
界面、连接与开发接口10 篇
- 队列很快结束却没有新文件:检查缓存、输出节点和保存位置
- 更新或安装扩展后白屏:分开检查浏览器与 Python 后端
- 工作流保存失败:先保住画布,再查保存请求
- 核心更新了却找不到新节点或模板:核对多个组件版本
- 无法连接 127.0.0.1:8188:先确认服务实际在哪里运行
- Address already in use:查清占用端口的进程再启动
- Failed to fetch 不一定是 ComfyUI 崩了:先找到失败的请求
- Manager 获取节点列表失败:先查目录请求,不急着重装节点
- POST /prompt 返回 400:先读 error,再看 node_errors
- WebSocket 有连接却收不到结果:按 prompt_id 跟踪终止状态