知仓学习社知仓学习社
报错库 / 全站资源搜索
搜索 更新 2026-10-02

报错库

共 112 条报错、11 个类别。 每条都先一字不改地贴出报错原文，再给根因与分步解法。你是拿那段文本去搜的，页面要么精确匹配，要么你根本找不到它。

数据来源 本页 112 条来自《ComfyUI 报错速查与解决手册》（2026-09-26 版）， 手册里带 [未核实] 标记的说明在本站原样保留：共 27 条含此类标记。

安装、启动与运行环境　11 条

【001】双击 run_nvidia_gpu.bat 窗口一闪而过：c10.dll 缺失，需要安装 VC++ 运行库 双击 run_nvidia_gpu.bat 后命令行黑窗一闪就关闭，浏览器打不开 127.0.0.1:8188，看不到任何可用报错信息。 有来源 【002】端口 8188 被占用：Address already in use / 上次的 ComfyUI 进程没退干净 启动时终端抛出 Address already in use，浏览器打开 127.0.0.1:8188 显示的是上一次那个旧实例的界面，或者 有来源 【003】torch 加载失败：OSError [WinError 1114] 动态链接库(DLL)初始化例程失败 c10.dll 启动到加载 torch 时直接报错退出，日志里出现 WinError 1114 与 “Error loading ...\torch\lib 有来源 【004】便携版找不到内嵌 Python / 路径不对：'python' 不是内部或外部命令、系统找不到指定的路径 双击或手动执行启动脚本时提示“系统找不到指定的路径”或“'python' 不是内部或外部命令，也不是可运行的程序或批处理文件”，ComfyU 有来源 【005】用户名/路径含非 ASCII 字符或空格导致安装与启动失败 安装或启动时日志里路径被截断在被空格或特殊字母处（如 \Paul、C:\Users\ukasz\ 少了 Ł），报命令找不到或虚拟环境创建失败 有来源 【006】Torch not compiled with CUDA enabled：装的是 CPU 版 torch 或 torch 与驱动不匹配 启动过程中直接抛 AssertionError: Torch not compiled with CUDA enabled 退出，或界面起来 有来源 【007】Python 版本不满足 ComfyUI 要求（requires-python >=3.10，旧环境 3.9 及以下不适用） 在旧版 Python 环境里安装或运行 ComfyUI 时，pip/包管理器在解析依赖阶段就拒绝安装；或在很旧的解释器上出现语法/语法特性不 有来源 【008】磁盘空间不足 / 下载解压中断导致安装与启动失败 安装或启动过程中报解压/写入失败，或启动时提示依赖包缺失、目录不完整；磁盘剩余空间很少时尤为明显。 有来源 【009】更新后启动失败：只 git pull 没更新依赖，或误用 update_comfyui_and_python_dependencies.bat git pull / 更新脚本跑完后 ComfyUI 启动异常：前端界面缺失或显示异常、找不到新工作流模板、节点帮助文档过时，甚至直接起不来 有来源 【010】启动参数/监听地址写错导致起不来：no available ports found between 8000 and 9000 桌面版按网上教程启用局域网访问后就再也起不来，反复重装也没用；或便携版加了 --listen 之后局域网其他设备仍连不上。 有来源 【011】杀毒软件/Windows Defender 拦截导致安装不完整、启动失败或文件被隔离 安装过程中进度中断或装完后启动失败，日志里出现 Python 进程异常退出、文件缺失或权限类错误；安全软件的隔离区里能找到 ComfyUI 有来源

显存与内存不足（OOM）　11 条

【012】最典型的爆显存：KSampler 阶段 torch.cuda.OutOfMemoryError: CUDA out of memory. Tried to allocate ... 排队出图后控制台刷红字，进度条卡在 KSampler（或 VAE Decode）阶段不动，ComfyUI 面板提示 Prompt execu 有来源 【013】新版报错：torch.OutOfMemoryError: Allocation on device 0 would exceed allowed memory.（附带 batch_size TIPS） 最近版本 ComfyUI 报出的 OOM 不再写 CUDA out of memory，而是打印一段带 Currently allocate 有来源 【014】VAE 解码阶段爆显存：Ran out of memory when regular VAE decoding, retrying with tiled VAE decoding 采样阶段一切正常，进度条走到 VAE Decode 才炸；或控制台提示已自动改用分块解码，但图像变黑、出现接缝、视频音轨变得莫名其妙。 有来源 【015】系统内存/页面文件不足：OSError: The paging file is too small for this operation to complete. (os error 1455) 不是显存报错而是 Windows 系统层面报错：加载大模型（UNETLoader / CheckpointLoaderSimple）或做分块 含未核实 【016】Windows 共享显存（Shared GPU memory）被吃满，任务管理器显示显存未释放、必须重启 任务管理器里“共享 GPU 内存”一路涨到几 GB 甚至十几 GB，独立显存看起来只占了一半，但 ComfyUI 仍然报 OOM；即使关掉 含未核实 【017】显存明明还有空余却报 OOM：分配器碎片化与 soft_empty_cache 未回收 nvidia-smi 或任务管理器看着还有 1-2GB 空闲显存，ComfyUI 却报 OOM；或者只用简单工作流、什么都没改，某次更新后突 含未核实 【018】模型叠加导致 OOM：ControlNet + IPAdapter + 多个 LoRA 把显存吃满 单纯出图没问题，一加上 ControlNet、IPAdapter 或叠两个以上 LoRA 就 OOM；显存越高越明显（24GB 卡上也会出现 有来源 【019】启动参数怎么选：--lowvram / --novram / --highvram / --normalvram / --gpu-only / --reserve-vram / --disable-smart-memory 的真实语义 显存不够时把网上看到的参数全抄一遍，结果有的参数互相冲突（vram_group 是互斥组），有的在新版完全不起作用，甚至更慢或更容易 OOM 含未核实 【020】注意力后端与 offload 参数对显存的影响：xformers / SageAttention / flash-attention / async-offload / pinned memory 换注意力后端后显存占用与速度差别很大：有的组合明显省显存且更快，有的组合反而 OOM 或输出噪点；钉住内存（pinned memory）在内 含未核实 【021】反复出图后内存/显存不释放，越跑越慢最后崩溃，只能重启 单张出图正常，连续出图 10 张以后越来越慢，系统内存/显存被吃满、开始使用交换文件，最终 ComfyUI 进程被系统杀掉。重启 Comfy 有来源 【022】显卡被其他程序占用显存：游戏、浏览器硬件加速、OBS 或残留进程导致“凭空 OOM” 同一工作流昨天还能跑，今天一启动就 OOM；nvidia-smi 显示显存已被占用但找不到 ComfyUI 的进程；关掉浏览器、游戏或结束残 有来源

依赖缺失与自定义节点安装失败　11 条

【023】报错 No module named 'insightface'（IPAdapter 人脸加载器 / ReActor 换脸节点不可用） 装好 IPAdapter_plus 或 ReActor 后，人脸相关节点在界面上报错；启动日志里该节点目录出现 IMPORT FAILED， 有来源 【024】一个节点包报错导致 / 或看似导致所有自定义节点加载中断（Cannot import ... custom_nodes） 启动时 custom_nodes 下多个目录接连报导入失败，界面里大量节点变红或干脆不出现；工作流加载时提示一堆 node types we 有来源 【025】报错 No module named 'cv2'（controlnet_aux / WanVideoWrapper 等节点导入失败） 装了 comfyui_controlnet_aux（ControlNet Aux）、WanVideoWrapper（UniAnimate/D 有来源 【026】报错 ImportError: DLL load failed while importing onnxruntime_pybind11_state（缺 Visual C++ 运行库 / onnxruntime 版本不匹配） 依赖 onnxruntime 的节点（如 WD14-Tagger、部分 ControlNet 预处理器、人脸/分割节点）启动即导入失败，日志 有来源 【027】报错 ImportError: cannot import name 'cached_download' from 'huggingface_hub'（diffusers 与新版 huggingface_hub 不兼容） 安装依赖 diffusers 的节点（MagicClothing、部分换装/Flux 类节点）后，启动日志报 cannot import n 有来源 【028】工作流加载后提示缺少节点 / 节点显示红色（Warning: Missing Node Types） 打开别人分享的工作流后，节点显示为红色（红色节点/红框），顶部弹出缺节点提示并列出节点名；点 Manager 的 Install Missi 有来源 【029】Manager 里点安装没反应 / 提示不允许该操作（security level 拦截或 git 路径未配置） 在 ComfyUI Manager 里点 Install / 通过 git URL 安装 / 安装 nightly 版本时失败或无反应；日志 有来源 【030】报错 Microsoft Visual C++ 14.0 or greater is required（节点依赖需要现场编译 C++ 扩展） 通过 Manager 或 pip 安装某节点时，日志最后是 Failed building wheel / Could not build 有来源 【031】报错 No module named 'pkg_resources'（setuptools 升级后 install.py 直接崩溃） 双击节点的 install.bat 或让 Manager 执行安装脚本时，脚本立刻抛 No module named 'pkg_resour 有来源 【032】pip install 装到了系统 Python 而不是 ComfyUI 内置 Python（依赖显示已装但节点仍报缺包） 节点目录明明在 custom_nodes 里，启动日志却逐个报 Cannot import ... No module named 'xxx 有来源 【033】报错 SSL: CERTIFICATE_VERIFY_FAILED（pip / Manager 拉取节点与依赖时证书校验失败） pip 安装或 Manager 拉取节点清单时报 SSL 证书校验失败，下载中断；同一网络下浏览器可能正常，命令行却失败。 有来源

模型与权重文件加载　11 条

【034】加载模型报 Error while deserializing header: HeaderTooLarge（文件根本不是 safetensors） 点队列或切换模型时红色报错，提示 header 太大，看起来像 ComfyUI 坏了或显卡/Python 环境出问题，实际上文件本身不是 s 有来源 【035】加载模型报 MetadataIncompleteBuffer 或 incomplete metadata：文件下载被截断 上一次还能用的模型突然加载失败；报错出现在 CheckpointLoaderSimple、VAELoader、CLIPLoader 或自定义 有来源 【036】下拉框里找不到模型 / 报 Value not in list: ckpt_name not in []（模型放错目录或没刷新） 打开别人分享的工作流，点执行时红色提示 Prompt outputs failed validation；节点下拉框为空或选不到自己刚放进去 有来源 【037】LoRA 加载报 lora key not loaded：LoRA 与底模架构不匹配或被当成 checkpoint 加载 LoRA 节点没有报致命错误，只是控制台刷出一大片 lora key not loaded / clip missing，出图看起来完全没吃 有来源 【038】IPAdapter 报 ClipVision model not found：CLIP Vision 是独立文件，需放进 models/clip_vision 运行 IPAdapter / 参考图相关工作流时报找不到 ClipVision 模型，或节点下拉框里选不出 CLIP Vision 文件，工 有来源 【039】GGUF 量化模型加载失败：节点缺失、放错目录、与 fp8 混用 加载 GGUF 量化模型时不显示节点变成红框（node types were not found），或者节点在但报无法识别模型类型 / 不支 有来源 【040】fp8 / 量化模型加载报错：comfy_kitchen 缺失、weight_dtype 设错、显卡不支持该格式 加载 fp8 / nvfp4 / int8 量化模型时，要么启动日志警告 fp8 与 fp4 支持不可用，要么模型能加载但采样阶段崩在矩阵乘 有来源 【041】CLIP / 文本编码器缺失或配错：双编码器模型只给了一个、SDXL 与 Flux 混淆 工作流能加载模型但文本编码阶段报错，或生成的图完全不受提示词影响、出图为噪声；Flux 工作流里两个 CLIP 槽位填了同一个文件也会出问题 有来源 【042】VAE 与模型不匹配：出黑图、雪花噪点、花屏或颜色异常 工作流能跑完但出图是黑图、灰蒙蒙一片、满屏雪花噪点或花屏；或者直接在 VAE 解码阶段报通道数不匹配的张量维度错误。 有来源 【043】加载 checkpoint 报 EOFError: Ran out of input / PytorchStreamReader failed（旧式 ckpt 文件损坏或不完整） 加载 .ckpt（或某些 .pth/.pt）模型时直接抛 Python 异常，可能是一句毫无上下文的 Ran out of input，也可 有来源 【044】Windows 加载大模型崩溃：The paging file is too small (os error 1455) 加载大 checkpoint 或 UNET 时进程突然崩溃或抛 os error 1455；也可能在 Python 导入 torch 的瞬间 有来源

执行期运行时错误（张量/尺寸/节点）　11 条

【045】生成时报张量尺寸不匹配：The size of tensor a (X) must match the size of tensor b (Y) at non-singleton dimension Z 点 Queue Prompt 后进度条跑到一半卡住，红色错误框弹出，提示两个张量在某个维度上长度对不上；通常发生在采样之后、VAE 解码阶段 有来源 【046】拼接/拼接 latent 时报：Sizes of tensors must match except in dimension 1 视频/图像模型跑到一半报错，提示两个待拼接的张量尺寸不同，且明确点名是列表里的第几个张量（tensor number 1）。 有来源 【047】矩阵乘法形状不匹配：mat1 and mat2 shapes cannot be multiplied 采样节点（KSampler / SamplerCustomAdvanced）执行时报矩阵乘法维度对不上，图片出不来。 有来源 【048】卷积通道数不匹配：Given groups=1, weight of size ..., expected input ... to have N channels 采样或 VAE 解码阶段报卷积层通道数不符，报错里同时给出权重通道数与输入通道数。 有来源 【049】精度类型不匹配一：expected scalar type Half but found Float 采样时突然报类型错误，提示需要 Half（fp16）却拿到了 Float（fp32），常见于挂了 AnimateDiff、ControlNe 含未核实 【050】精度类型不匹配二：Input type (torch.FloatTensor) and weight type (torch.HalfTensor) should be the same 工作流之前能跑，某次更新后第一个 IPAdapter 节点就报类型不匹配；删掉节点重建也无效。 含未核实 【051】设备不一致：Expected all tensors to be on the same device（低显存把权重换到 CPU 后触发） 采样过程中报错说有两个设备上的张量参与同一个运算；往往发生在显存吃紧、模型被自动换出到内存的时候。 含未核实 【052】上游节点返回空：'NoneType' object has no attribute 'shape' 执行到某个节点时突然报 NoneType，日志里看不出是哪个输入没接，但能看出是哪一类节点在取 .shape。 有来源 【053】报错后不知道是哪个节点炸的：如何用 "Error occurred when executing" 定位 点了运行之后只看到一大段 traceback，不知道是画布上哪个节点出的问题，也不知道该改哪个参数。 有来源 【054】torch / torchvision 版本不匹配：Could not run 'torchvision::nms' with arguments from the 'CUDA' backend 一用到检测类节点（人脸检测、YOLO 检测等）就报 NotImplementedError，不动这些节点时一切正常。 有来源 【055】分辨率/帧数不是模型要求的整数倍导致的尺寸类报错 把宽高或帧数设成任意数值后报尺寸相关错误；或者不报错但输出被悄悄改小、边缘被裁掉、img2img 结果对不齐。 含未核实

PyTorch、CUDA 运行库与加速库冲突　11 条

【056】启动或首次生成时报 AssertionError: Torch not compiled with CUDA enabled（装成了 CPU 版 torch） ComfyUI 能启动，但一点生成就报 Torch not compiled with CUDA enabled，或者启动日志里显示设备是 有来源 【057】50 系显卡第一次卷积就崩：CUDA error: no kernel image is available for execution on the device ComfyUI 能正常启动、甚至能加载模型，但一开始采样就报 CUDA error: no kernel image is availabl 含未核实 【058】启动直接崩：torch / torchvision / torchaudio 三者 CUDA 版本不一致 ComfyUI 在 import 阶段就抛 RuntimeError 无法启动，报错文字直接说明两个包的 CUDA 版本号不一致；也可能表现 含未核实 【059】节点执行时报 Could not run 'torchvision::nms' / operator torchvision::nms does not exist ComfyUI 能启动，但一旦进到人脸检测、分割、检测类节点（Impact Pack、ControlNet Aux 等用到 torchvis 含未核实 【060】自定义节点装完 / 更新依赖后 torch 被偷换成 CPU 版（依赖漂移） 昨天还好好的，装了一个新自定义节点（或点了 Manager 的“安装依赖”）并重启后，ComfyUI 突然只走 CPU、或直接报 Torch 有来源 【061】装完 xformers 后 torch 被降级、加速库反而让 ComfyUI 崩（xformers 陷阱） 为了让注意力更快装了 xformers，结果重启后原本正常的出图在第一个采样步就崩，或输出全黑；另一类情况是节点报 No module na 含未核实 【062】生成中途崩：CUDA error: device-side assert triggered / an illegal memory access was encountered / unspecified launch failure 生成过程随机在某个采样步崩溃，报 device-side assert / illegal memory access / unspecif 有来源 【063】驱动太旧：The NVIDIA driver on your system is too old / CUDA driver version is insufficient for CUDA runtime version 更新 torch 到更高的 CUDA 版本后，ComfyUI 报驱动太旧或 CUDA driver version is insuffici 含未核实 【064】Windows 上 No module named 'triton' / SageAttention 无法导入 启动或执行 WanVideo 等依赖 SageAttention 的节点时报 No module named 'triton'；ComfyU 含未核实 【065】numpy 2.x 覆盖后大量节点无法加载：A module that was compiled using NumPy 1.x cannot be run in NumPy 2.x / _ARRAY_API not found 更新依赖或装了某个节点之后，一批自定义节点集体 IMPORT FAILED，日志里刷满 NumPy 1.x/2.x 不兼容的警告与 _ARR 有来源 【066】onnxruntime-gpu 与 CUDA 版本不匹配导致检测节点悄悄退回 CPU（Failed to create CUDAExecutionProvider） 人脸检测 / 姿态估计（DWPose）等用 onnxruntime 的节点在启动时给出 CUDAExecutionProvider 相关警告 含未核实

网络、下载与访问（含国内网络环境）　11 条

【067】启动或加载工作流时连不上 huggingface.co，控制台报最大重试次数已超过 ComfyUI 启动时、或加载需要在线拉取模型/配置的节点时报错，控制台出现连接 huggingface.co 超时或重试用尽的堆栈，界面卡 有来源 【068】SSL 证书校验失败：CERTIFICATE_VERIFY_FAILED unable to get local issuer certificate 任何需要 HTTPS 的操作（下载模型、安装/更新节点、启动时拉取数据）都失败，报 SSL 证书校验不通过；浏览器访问同一个网址却正常。 有来源 【069】transformers 报 We couldn't connect to 'https://huggingface.co' to load this file 使用带 transformers 的节点（文本编码、打标、翻译、提示词扩写等）时报错，提示无法连接 huggingface.co 且在本地缓 有来源 【070】huggingface_hub 本地找不到文件：LocalEntryNotFoundError / EntryNotFoundError 自定义节点在下载/加载模型时报 LocalEntryNotFoundError 或 EntryNotFoundError，节点标红、工作流中 含未核实 【071】Gated 仓库无权访问：需要登录并同意协议（Llama / Flux 等） 下载 Llama、Flux 等需要授权的模型时报 401/GatedRepoError，提示无权访问该 gated 仓库或需要登录；有时在镜 含未核实 【072】ComfyUI-Manager 安装节点失败：连不上 GitHub（Failed to connect to github.com port 443） 在 Manager 里点安装/更新节点后弹出安装失败，或手动 git clone 节点仓库时直接连不上 github.com，443 端口超 有来源 【073】git clone / git pull 卡住或报 OpenSSL SSL_read: Connection was reset, errno 10054 更新 ComfyUI 或拉取节点仓库时 git 长时间卡住，最后报 Connection was reset / errno 10054 或 有来源 【074】Manager 列表刷不出来：Due to a network error, switching to local mode（含 SOCKS 代理场景） 打开 ComfyUI-Manager 时 Custom Nodes Manager 加载不出来或列表是旧的，控制台反复打印 FETCH DA 有来源 【075】给 ComfyUI 设置了代理但不生效（便携版 bat、桌面版重启动丢失代理） 明明配了代理，ComfyUI 里下载/安装依然失败；或者桌面版用 bat 设了代理能用，一点 ComfyUI 菜单里的「重启」代理就失效了， 有来源 【076】pip 安装依赖超时/极慢，节点安装卡在 pip install 安装或修复自定义节点时，pip install 长时间无响应最后超时失败；Manager 报安装失败或提示依赖未安装，节点重启后仍显示缺失。 含未核实 【077】设了监听还是进不去：--listen 0.0.0.0 后局域网/手机仍无法访问 8188 为了从手机/平板/另一台电脑访问，加了 --listen 0.0.0.0 启动，但对方浏览器依旧打不开 8188；有的版本甚至直接报 unr 有来源

前端界面、浏览器与工作流加载　11 条

【078】打开 127.0.0.1:8188 只有空白页或一直转圈，界面加载不出来 服务端控制台已经打印出 "To see the GUI go to: http://127.0.0.1:8188"，但浏览器里页面全白，或一 有来源 【079】工作流所有节点变红、提示缺少节点或 Cannot find node，无法执行 打开别人的工作流后一片红，或执行时弹出 "Cannot execute because a node is missing the clas 有来源 【080】新版前端与旧工作流不兼容：旧工作流节点错位、widget 丢失或值变成 undefined 升级新版前端后，以前能跑的工作流打开时节点位置错乱、参数（widget）消失或显示 undefined，subgraph 里的内容渲染不正常 有来源 【081】浏览器控制台报 Failed to load resource: ERR_CONNECTION_REFUSED，页面打不开或功能全失效 页面能打开但功能全不可用：侧栏日志区显示 "Failed to fetch server logs"，执行到某个进度后出现 "Reconne 有来源 【082】出图成功但看不到图：预览 404、保存的图片找不到 队列显示执行完成、控制台也打印了耗时，但节点上没有预览图；或者在「从输出加载图片」之类的节点里选中图片后报 404，同时磁盘上确实找不到刚出 有来源 【083】WebSocket 断开／Reconnecting，进度条卡在 0% 但后端其实已经出图 进度条长时间停在 0% 或某个百分比不动，界面反复显示 Reconnecting，同时后端终端能看到工作流其实还在跑甚至已经出图；也可能界面 有来源 【084】拖入 .png 开不出工作流：Unable to find workflow 把带工作流的 png 拖进 ComfyUI，或走 Workflow → Open 选择该 png，弹出找不到工作流的提示框，节点图出不来；同 有来源 【085】队列卡住：任务一直 pending、Cancel 无效，只能重启 Queue 面板里任务长时间停在 pending 或 running，点 Cancel 没有反应，执行进度也不再变化；重启 ComfyUI 有来源 【086】ComfyUI Desktop 桌面版装完打不开：白屏或一直转圈 ComfyUI Desktop 安装完成后启动界面一直转圈、白屏或停在下不了载的维护页面，反复重装也一样；便携版命令行启动却是好的。 有来源 【087】API 调用 /prompt 报 400/422/500：Prompt outputs failed validation、Value not in list、invalid prompt 通过 /prompt 接口提交工作流时报 400/422/500，返回体里是 prompt_outputs_failed_validatio 有来源 【088】出图过程中界面越来越卡、最后完全冻结，工作流动不了 打开工作流后画面卡住：要么什么都看不到，要么停在某张冻结的画面上，鼠标无法移动、无法滚动、无法拖动节点；有时跑完一段时间后越来越卡直到卡死。 有来源

硬件、驱动、操作系统与非 N 卡环境　11 条

【089】50 系显卡（RTX 5060 Ti / 5070 / 5080 / 5090）驱动版本太旧，ComfyUI 启动或生成直接失败 换了 50 系新卡（如 RTX 5060 Ti 16GB）后，ComfyUI 能启动、能排队，但一执行到采样或 CLIPTextEncode 含未核实 【090】RTX 50 系 / 新卡报 CUDA error: no kernel image is available for execution on the device（跑到了没有 sm_120 kernel 的 torch 上） ComfyUI 能进界面，队列也能跑，但一到某个节点就整段红色报错，报错节点常是 CLIPTextEncode 或 KSampler；换显卡 有来源 【091】Blackwell 显卡生成在第一个注意力层失败：cuDNN Frontend error: No valid execution plans built 在 Blackwell 代 NVIDIA 显卡上跑 FLUX 等模型时，进度条刚起步就在第一个注意力块报错，完全出不了图。 含未核实 【092】在 cmd 里敲 nvidia-smi 提示“不是内部或外部命令”：驱动装的是 DCH/未装 NVIDIA 驱动或 PATH 里没有 System32 想按教程检查显卡，结果 cmd 里 nvidia-smi 直接提示命令不存在；或者能运行但报 could not communicate w 有来源 【093】ComfyUI Desktop 报 “ComfyUI requires an NVIDIA GPU on Windows. No NVIDIA GPU was detected” 卡在启动页（含被迫用 --cpu 的慢速兜底） ComfyUI Desktop 安装后第一次启动就停在“需要 NVIDIA GPU”的提示页，无法进入下一步；显卡本身是好的（如 RTX 3 有来源 【094】多显卡机器上 ComfyUI 用错了卡：需要指定 CUDA_VISIBLE_DEVICES 或 --cuda-device 机器上插了两块及以上显卡（例如 3090 + 5060 Ti，或独显 + 集显），ComfyUI 启动日志里的 Device 永远是 cud 有来源 【095】笔记本/台式机混合显卡：ComfyUI 跑在核显上（集显占用 GPU，独显闲置） 生成能跑但极慢，任务管理器里 GPU 占用发生在 Intel/AMD 核显上，NVIDIA 独显几乎没有负载；或者 ComfyUI 干脆以 有来源 【096】AssertionError: Torch not compiled with CUDA enabled（装了 CPU 版 torch，或装到了系统 Python） ComfyUI 启动或执行时报 AssertionError: Torch not compiled with CUDA enabled；同 有来源 【097】AMD 显卡跑 ComfyUI：Windows 不支持/DirectML 已废弃，Linux ROCm 装好了又认不到 GPU AMD 显卡用户在 Windows 上按 NVIDIA 教程装完 torch 后报 Torch not compiled with CUDA 含未核实 【098】Intel Arc / 核显用户报 Torch not compiled with CUDA enabled：其实是该走 XPU 而不是 CUDA Intel Arc 独显或 Core Ultra 核显用户装完 ComfyUI 报 Torch not compiled with CUDA 有来源 【099】Apple Silicon Mac 报 MPS backend out of memory：统一内存被 MPS 缓存吃满 Mac（M1/M2/M3/M4）上跑到 KSampler 或 VAE 解码阶段报 MPS backend out of memory；提高分 有来源

热门自定义节点/工作流专有报错　11 条

【100】打开别人的工作流，节点全变红，提示节点缺少 class_type 属性 从网盘/社区下载的工作流 JSON 拖进 ComfyUI 后，画布上一片红色节点，点队列运行直接报错，或者提示 Cannot execute 有来源 【101】ComfyUI-Manager 连不上 Comfy Registry，刷新缓存失败 打开 Manager 时日志里刷出 Cannot connect to comfyregistry，或者提示 ComfyRegistry 缓 含未核实 【102】ComfyUI-Impact-Pack 导入失败：No module named 'ultralytics'（缺少检测模型依赖） 启动 ComfyUI 时命令行出现 Impact Pack 的 IMPORT FAILED，节点面板里 FaceDetailer、Ultra 有来源 【103】comfyui_controlnet_aux 导入失败：No module named 'timm' 升级 ComfyUI 或重装节点后，ControlNet Aux 的全部预处理器节点（Canny、Depth、OpenPose、Linear 有来源 【104】WanVideoWrapper：No module named 'sageattention'（SageAttention 未安装或装错环境） 用 kijai 的 WanVideoWrapper 跑 Wan 视频工作流，点运行时立刻报 No module named 'sageatt 含未核实 【105】VideoHelperSuite：ffmpeg is required for video outputs and could not be found VideoHelperSuite 的 Video Combine 节点能把帧跑完，但合成 mp4 那一步失败或输出无声/无文件；命令行提示找 有来源 【106】insightface 在 Windows 上编译失败（Building wheel for insightface finished with status 'error'） 装 ReActor / InstantID / PuLID / IPAdapter FaceID 时，pip 在 building whee 有来源 【107】ComfyUI-GGUF：加载量化模型报 GGML_ASSERT 断言失败 用 ComfyUI-GGUF 的 GGUF 加载器载入量化模型时，进程直接崩溃/抛出断言失败，错误里带 GGML_ASSERT；有时是加载阶 含未核实 【108】IPAdapter Plus：IPAdapter model not found（模型文件或目录放错） IPAdapter 节点一执行就报 IPAdapter model not found；或者报了另一类 KeyError: 'clipvis 有来源 【109】AnimateDiff：找不到运动模块 mm_sd_v15_v2.ckpt（motion module 缺失） AnimateDiff 工作流执行到加载器节点就直接报错结束；节点上的 motion module 下拉框是空的，选不到任何运动模块；有时能 有来源 【110】ReActor / 换脸节点导入失败，facexlib 等依赖缺失或模型下载失败 ReActor 节点装好后在节点列表里找不到，启动日志里该节点包 IMPORT FAILED；或者节点在，但一运行就报模型文件问题（如 in 有来源

本机环境专项　2 条

【111】启动日志警告 You need pytorch with cu130 or higher（comfy_kitchen 的 CUDA 后端被禁用） ComfyUI 能正常启动、也能正常出图，但启动日志里出现黄色 WARNING，提示需要 cu130 以上的 PyTorch；同时 comf 含未核实 【112】GitHub 与 huggingface.co 直连超时：自定义节点装不上、模型下载中断（本机网络实测） 浏览器明明能上网，但 ComfyUI-Manager 里点安装节点一直转圈或失败，模型库下载不动，git clone 超时；控制台里常见连接 含未核实

返回首页