错误排查方法一复制报错内容到google或百度直接搜索，查看相关报错和解决方案

二查看界面中红色描边的节点，表示输入未找到。如果缺少图片那么上传图片，缺少模型则重新选择对应的模型，如果发现没有可选模型可以将加载的模型名称输入到google进行搜索，一般是可以直接搜索到相关资源，下载后放到对应的模型目录即可。

三查看comfyui后台异常信息，先翻译异常尝试理解错误信息含义，或者复制到google进行搜索；一般的错误消息带有Error关键词，我们需要去寻找Error附近的日志信息，找到一行语义化相对明确，或简短的错误提示，将其复制然后搜索寻找答案。【注：不是所有Error都是严重错误，有些Error不会影响正常使用】

四常见报错格式说明：一般我们需要关注异常原因，通过搜索异常原因关键词找到对应的解决方案。其次需要注意是什么节点抛出的异常，也就是异常组件。针对不同节点有不同的解决方案，要更具实际情况判断；异常代码信息，通常不需要关注，对于大部分使用者提供不了有用的信息，除节点开发者外；

常见异常

1'NoneType'object has no attribute lower' 错误说明：缺少模型输入，找到红色描边节点并重新选择模型

2[Errno 2] No such file or directory 错误说明：未找到图片路径，查看红色描边的节点选择choose file to upload重新上传图片即可

3out of memory 错误说明：内存溢出，出现这个关键词表示你的内存以及达到上限了。关闭掉多余的软件并尝试重启comfyui再次运行，如果还是跑不了说你的内存确实不足，加内存条吧铁汁~

4'NoneType' object has no attribute 'shape' 错误说明：模型版本不匹配，确保模型选择了正确的版本。

5When loading the graph,the following node types were not found 错误说明：缺少插件节点，在管理器中搜索并安装对应的节点。如果你搜索出来发现以及安装，那么尝试更新节点到最新版本。如果还是没有，那么检查一下启动过程中是否存在关于此插件的加载失败异常；

6mat1 and mat2 shapes cannot be multiplied (32x2048 and 768x320) 错误说明：大模型/lora/controlnet这些模型的版本不匹配，或者某插件不兼容该版本的模型。确认所有的模型版本均一致，现在主流的是SD1.5模型或者SDXL模型，确保大模型/lora/controlnet都使用的相同版本模型

7HTTPSConnectionPool host='raw.githubusercontent.com',port=443 错误说明：在运行某些插件节点时，插件会自动下载所需的模型。这些模型并不是我们通俗说的大模型/lora等，而是其模型自身运行所需的模型或必要文件。下载地址通常指向国外，需要通过学术加速来解决网络问题，然后再次运行工作流，直到下载成功。

秋叶整合包中，你可以尝试开启DL设置(需要配置你的学术加速IP 或端口)，或者打开国内加速镜像。重新启动后再次下载，下载进度可在控制台查看。

还有一种方式是，手动下载插件所需模型，然后放到对应的文件夹中。例如在这个异常中，我们可以看出这里是instantid中的节点，在模型加载器这里去下载的模型。我们就可以通过去寻找instantid插件所需的必要模型，手动放置到对应的模型目录下后，重新运行工作流。

8ClipVision model not found 错误说明：视觉模型未找到，视觉模型位于models/clip_models目录下，目前主流的视觉模型就两个，SD1.5的和SDXL版本的。可以通过我的网盘链接去下载clip视觉模型然后放到models/clip_models目录下https://pan.quark.cn/s/51fb07593cad；

9insightface model is required for FaceID models 错误说明：ipadapter节点的异常，要求传入一个faceid的模型。ipadapter目前有两大模型体系，一个是普通的风格模型ip-ipadapter 或 plus，普通风格模型中又有plus版本的加强模型，顾名思义对风格的模型更加到位。还有一类是faceid的面部特征参考模型，分普通版/plus/plusV2等版本，需要配合ipadapter faceid节点一起使用，用于模仿人物面部特征；且所有风格模型都有SD1.5和SDXL两大模型版本，所以在使用时一定要注意于大模型版本对应；下载地址：https://pan.quark.cn/s/9b3dda7daf32

10Preset text 'default negative'not found.Please fix this and queue again. 错误说明：工作流中使用到了预设文本的节点，该节点的预设配置名称为“default negative”，且你当前的工作流环境中没有该预设名称的配置；在开发工作流时，不介意使用预设文本这个节点，如果其他人没有会导致一直出现该弹窗，无法关闭。

11UNetModel'object has no attribute 'default_image_only_indicator 错误说明：freeu插件和当前内核不兼容，节点管理器中搜索freeu插件将其卸载重启即可；

12OpenCV (4.7.0) (-215:Assertion failed) clipseg插件问题，使用的API和当前环境不兼容，需要修改其代码进行调整；

编辑custom_nodes/clipseg.py文件的代码：

1.找到这部分代码位置 2.修改为如下这是以及编辑过的版本，你可以直接下载下来替换本地文件： clipseg.py(10 KB)

13Permission denied: selfie_multiclass_256x256.tflite 该错误是由于插件下载文件命名有误会导致，在comfyui根目录下找到models\mediapipe\selfie_multiclass_256x256.tflite文件夹，将下面的同名文件替代文件夹

修改完成后如图所示：

14/hustvl/vi tmatte-smal1-composition-1k/resolve/main/config. json下载失败，网络超时

15缺hustvl插件，在全量插件中下载一下hustvl目录，然后放到comfyui根路径下 Error occurred when executing LayerMask:PersonMaskUltra V2: We couldn't connect to'https://huggingface.c load this file,couldn't find i the cached files and it looks like hustvl/vitmatte-small-composition-lk not the path to a directory containing afile named config.json.Checkout your internet conmection or see how to run the library in offline mode

https://pan.quark.cn/s/038a23cfbeb5

16更新了主体，没更新插件会导致 Error occurred when executing ApplyInstantID: CrossAttentionPatch object has no attribute 'add'

17Error occurred when executing IPAdapterAdvanced: LORA没有选择，或者模型没选择对，检查LORA，Controlnet模型

18CUDA PATH is set but CUDAwasnt able to be loaded, Please install the correct version of CuDA andcuDNN asmentioned in the GPu reguirements page "xxx" make sure they're in thePATH, and that your GPl is supported.

onnxruntime的依赖库版本需要升级到最新，cmd进入到comfyui整合包的python目录下依次执行以下命令： —— 解决人（Rick）

19big-lama.pt路径正常，加载失败

问题点:iopaint库不支持中文路径，中文路径更改后，big-lama.pt可以正常加载 ——解决人（黄冠群）

20Error occurred when executing LayerMask: MaskEdgeUltraDetail V2:——..models/vitmatte

解决方法

https://pan.quark.cn/s/038a23cfbeb5 下载后把这个文件夹vitmatte，放到模型文件夹models跟目录 ——解决人（江宁）

21manager里面下载失败

安装失败属于没有网络，后台可以看到远程服务器积极拒绝，链接魔法即可 ——解决人（张悠米）

22动态链接库(DLL)初始化例程失败，

撞大运了，这是环境损坏，需要重装整合包所有环境，推荐重新下载整合包，大家都玩儿坏，看开点 ——解决人（张悠米）

23Error occurred when executing SDXLPromptStyler

解决方法：这里重新点选下需要的风格

——解决人（江宁）

24no image matches the filter criteria

生成的图像相似度dist值超过1时，超过filter_thresh默认值1.000，会报以上故障，最简单的办法就是把filter_thresh调整到2，这样就不会报故障，避免学员抱怨。 ——解决人（黄冠群）

25Error occurred when executing KSampler(Efficient):

大模型和Lora有1.5和XL版本的区别，版本不兼容，混合使用会报这个错误，切换模型即可 ——解决人（张悠米）

26Error occurred when executing CropFaces :

V6换脸无法运行报错，更新插件，重新启动运行，等待自动下载模型 ——解决人（江宁）

27Error occured when executing Cropface

执行facetool插件cropface节点时，无法连接huggingface自动下载模型，检查发现秋叶启动器ip地址端口和浏览器代理地址端口不一致，导致无法连接网络，重新设置后恢复下载。此现像适用于其他无法连接huggingface和github场景，网络问题第一时间检查地址一致性。解决人：黄冠群 28Error occurred when executing ImageReceiver :

检查上传图片相关节点是否存在某节点未打开，处理忽略状态，框选然后打开即可解决人：张悠米

29换脸V6出现换脸变形形

关闭面部比例同步即可

解决人：张悠米

30Error occurred when executing KSampler: Given groups=1, weight of size [320, 4, 3, 3], expected input[2, 8, 192, 154] to have 4 channels, but got 8 charels instead

解决方法：

重新点选下，还点选原来的选项解决人：江宁

31Error occurred when executing KSampler:

解决方法：

安装节点重启即可。解决人：张悠米

32Error no face detect

换脸工作流随机生成面部时会出现黑图，因为变化幅度为0.5，所以生成3张以上，可能会出现黑图，把随机数量设置为2，99%可以避免黑图报错情况，适合批量图片使用

33Error occurred when executing KSampler:

解决人:悠米

34Error personMaskUltra V2

全能王V5，客户提交参考图中有两个人，同时打开了换脸加强，提示词反推也生成了两个人，导致人像面部遮罩识别出错，更换参考图为单人后解决。解决人：黄冠群

35Error occurred when executing SUPIR_first_stage: No operator found for `memory_efficient_attention_forward` with inputs: query : shape=(1, 4080, 1, 512) (torch.bfloat16) key : shape=(1, 4080, 1, 512) (torch.bfloat16) value : shape=(1, 4080, 1, 512) (torch.bfloat16) attn_bias :

解决方法:调整supir为自动解决人:江宁

36缺少以下节点 get latent size

解决方法:搜索同类节点进行替换

解决人:悠米

37WARNING:inference-c0.17.0 does not provide the extra’yolo-world'

这个警告信息表示你正在使用的inference-cli版本0.17.0没有提供名为'yolo-world'的额外功能。你可能需要升级到更高版本的inference-cli，或者检查你是否正确地安装了所需的额外功能。

解决方法:对组件进行升级解决人:悠米

38Error occurred when executing easy fullLoader :

解决方法:把两个插值方式改为comfyui 解决人:悠米

39Error in excute ksample

图像不是侧脸时，打开面部矫正，容易报错，关闭面部矫正后正常输出。解决人：黄冠群

40Loading aborted due to error reloading workflow data

更新iclight插件后，工作流加载崩溃，更新comfyui至最新版本后恢复正常。解决人：黄冠群

41Error occurred when executing StableSRColorFix:

换脸V5PLUS放大无法使用,更新解决问题解决人:江宁,9113

42云端反推卡住

解决人:悠米

43Error occurred when executing KSampler

数据通道异常，指定更新解决

解决人:悠米

44Error occurred when excute ksampler

lora堆加载异常，导致ksampler报错，关闭lora堆开关后恢复正常。解决人:黄冠群 9月15日

45换脸工作流，额头出现双层头发

用户脸部没有设置合适的遮罩大小，导致出图异常，调小遮罩扩展范围后恢复正常解决人:黄冠群 9月15日

46PuLIDEVAClip加载器 (MaxRetryError("HTTPSConnectionPool(host='huggingface.co', port=443): Max retries exceeded with url: /QuanSun/EVA-CLIP/resolve/main/EVA02_CLIP_L_336_psz14_s6B.pt (Caused by SSLError(SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1007)')))"), '(Request ID: 637f921a-afbb-4a34-86ea-c1132ca2a3be)')