报错排查
把日志变成可查阅的文章。
粘贴报错原文，或输入你看到的现象。匹配在浏览器内完成，不上传日志、不执行修复。
浏览器内匹配 · 不写入网址、浏览器存储或分析事件。离开本页或清空后，不保留输入；导出只包含文章指针。第三方浏览器扩展不在本站控制范围内。
这里只检索文章，不检查你的 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 跟踪终止状态