问题排查约 3 分钟阅读
FFmpeg 找不到：终端可用不代表节点进程也能找到日志关键词: ffmpeg not found
视频读取、转码、合成或预览节点提示找不到 FFmpeg 可执行程序。首先确认是可执行文件缺失，还是编码器、输入文件或节点内部路径错误，不要仅凭日志出现 ffmpeg 就重新安装全部视频依赖。
知识库
问题排查
已发布的参考资料、来源身份和关联阅读。
手上有报错原文？粘贴到「报错排查」查找对应文章 →
问题排查约 3 分钟阅读
DLL load failed：定位原生扩展，不要下载散装 DLL 覆盖系统日志关键词: DLL load failed
Python 模块导入时提示 DLL 无法加载。提示中的模块名可能是原生扩展，缺失的也可能是它的下游运行库；这和单纯 ModuleNotFoundError 的 Python 包缺失不同。
问题排查约 3 分钟阅读
VHS 合成后近乎静音：检查音频 dtype，而不是先放大音量日志关键词: VHS_VideoCombine
音频分支有输出，但经过 VHS_VideoCombine 合成后几乎听不见。此条目针对报告中与 fp16 中间结果有关的一类情况，不把所有静音都归因于精度。
问题排查约 3 分钟阅读
Prompt has no outputs：工作流里需要真正的输出终点日志关键词: Prompt has no outputs
请求包含若干加载和计算节点，但服务端没有找到本次要执行的有效输出节点。单纯在画布上生成 latent 或连接一些中间节点，并不必然构成完整执行目标。
问题排查约 3 分钟阅读
Address already in use：查清占用端口的进程再启动日志关键词: Address already in use
ComfyUI 启动时无法绑定端口，通常需要区分已有正常实例和其他服务占用。多次双击启动脚本可能制造多个互相冲突的实例，但不能看到端口占用就立即杀掉所有 Python 进程。
问题排查约 2 分钟阅读
GGUF 文件无法加载：容器格式相同不代表模型用途相同日志关键词: UnetLoaderGGUF
下载 GGUF 后，普通 checkpoint 节点找不到它或专用加载器仍报错。需要先确认该文件是受到当前节点支持的扩散模型或文本编码器，而不是任意聊天模型的 GGUF。
问题排查约 2 分钟阅读
提示缺少 yaml、PIL 或 pydantic_settings：先核对包名，不要照抄报错安装日志关键词: No module named yaml
把报错里的导入名称、安装名称和实际运行环境分开检查，避免装错包或装到另一套 Python。
问题排查约 2 分钟阅读
aiohttp、requests 找不到与网络连不上，不是一种报错日志关键词: No module named aiohttp
先检查模块是否存在，再区分 DNS、TLS、HTTP 状态与超时，不默认关闭证书校验。
问题排查约 2 分钟阅读
Manager 获取节点列表失败：先查目录请求，不急着重装节点日志关键词: Failed to get custom node list
区分远程目录、缓存、过滤条件、节点代码和 Python 导入，保留真实请求与错误记录。
问题排查约 2 分钟阅读
工作流保存失败：先保住画布，再查保存请求日志关键词: Failed to save workflow
先尝试导出独立副本，再区分草稿保存、文件下载和 API 格式，不以清缓存作为第一步。
问题排查约 2 分钟阅读
Failed to fetch 不一定是 ComfyUI 崩了：先找到失败的请求日志关键词: Failed to fetch
将页面、后端、日志、节点列表和工作流保存请求分别定位，避免用同一套办法处理所有连接错误。
问题排查约 3 分钟阅读
Float / Half / BFloat16 不一致：沿调用栈定位失败运算日志关键词: mat1 and mat2 must have the same dtype
dtype 错误不同于矩阵尺寸或设备错误。先看调用栈和不兼容的运算输入；仅凭 KSampler 报错不能判定是哪一组件造成了类型不一致。
问题排查约 3 分钟阅读
生成黑图或异常颜色：先定位采样、VAE 与显示环节日志关键词: invalid value encountered in cast
任务没有立即报错，却输出黑图、无效像素或明显异常颜色。先判断实际保存文件是否异常，再区分输入、采样、解码和显示问题；黑色预览与黑色成品不能混为同一现象。
问题排查约 2 分钟阅读
视频导出失败、黑屏或时长不对：检查编码与帧率链路日志关键词: Unknown encoder
视频节点读取或合成失败，或者输出文件存在但浏览器不能播放、时长异常、没有声音。本页围绕媒体处理层排查，不把这些问题全部归因于生成模型。
问题排查约 3 分钟阅读
Safetensors 头部错误：核对下载完整性，不要只靠改后缀日志关键词: HeaderTooLarge
加载 .safetensors 时解析头部失败。常见排查方向包括下载内容不正确、传输不完整、实际格式不同及加载器版本，但这条错误本身不能唯一证明文件损坏。
问题排查约 3 分钟阅读
Windows 错误 1455：分页文件过小不等于显存不足日志关键词: The paging file is too small for this operation to complete
Windows 在加载大模型或运行任务时提示分页文件过小。此错误涉及系统提交内存，不应直接套用 CUDA 显存不足的处理方式，更不能因为发生在 safetensors 加载时就认定权重已损坏。
问题排查约 3 分钟阅读
Hugging Face 401 / 403：浏览器能看不等于下载程序已获授权日志关键词: 401 Client Error
浏览器可以打开模型页面，但命令行、节点或下载脚本得到未授权或拒绝访问。这里首先检查资源访问资格与凭据身份，不应直接关闭 TLS 校验或寻找绕过受限仓库的方法。
问题排查约 3 分钟阅读
ControlNet 报错或不起作用：核对底模、控制图和应用节点日志关键词: ControlNet
分别排查 ControlNet 与底模兼容性、控制图预处理和条件链路；节点连线类型错误应单独诊断。
问题排查约 3 分钟阅读
WebSocket 有连接却收不到结果：按 prompt_id 跟踪终止状态日志关键词: execution_error
API 客户端能连接 WebSocket，也成功排队，但一直等待某个事件或没有取回结果。需要核对 client_id、prompt_id、终止事件和历史查询，而不是只以连接保持为成功条件。
问题排查约 3 分钟阅读
CLIP input is invalid: None：加载的 checkpoint 可能没有文本编码器日志关键词: CLIP input is invalid: None
CLIPTextEncode 等节点收到空的 CLIP 输入。需要检查编码器是否真的加载成功、连线是否正确，以及当前模型是否采用分体加载，而不是只看节点框上有没有一根线。
问题排查约 3 分钟阅读
LoRA 不生效或形状不匹配：先核对底模，再检查两条加载分支日志关键词: lora key not loaded
LoRA 能在列表中选择，却运行时报形状错误，或者输出几乎没有变化。本页合并处理“资源不匹配”和“流程没有真正应用”两类问题；没有变化只是观察结果，不必然证明 LoRA 损坏。
问题排查约 3 分钟阅读
No space left on device：区分模型、临时目录与输出盘日志关键词: No space left on device
下载模型、解压依赖或保存图片视频时出现磁盘空间错误。即使目标输出盘还有空间，下载缓存、系统临时目录、容器可写层或另一个挂载点仍可能已满。
问题排查约 2 分钟阅读
Mac 的 MPS backend out of memory：先看统一内存压力日志关键词: MPS backend out of memory
Apple Silicon 上的任务触发 MPS 内存上限。Mac 使用统一内存，浏览器、其他应用、模型和中间张量会共同影响可用空间，不能把机器总内存全部视为可分配给当前生成任务。
问题排查约 2 分钟阅读
SageAttention / Triton 导入失败：先核对平台与版本组合日志关键词: No module named 'triton'
ComfyUI 或自定义节点导入 SageAttention 时，可能找不到 Python 包或 Triton，也可能在 Windows 上无法加载 _fused 扩展。这些错误发生在不同层次，不能统一靠升级所有依赖处理。