ComfyUI错误排查手册：常见问题与解决方案大全
【免费下载链接】ComfyUI 最强大且模块化的具有图形/节点界面的稳定扩散GUI。 
项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI
ComfyUI作为最强大且模块化的具有图形/节点界面的稳定扩散GUI（图形用户界面），在使用过程中可能会遇到各种错误。本手册将详细介绍常见问题及其解决方案，帮助你快速排查并解决问题，确保项目顺利运行。
模型加载错误
模型文件不存在
当加载模型时，若出现“Model in folder 'checkpoints' with filename 'xxx' not found”错误，通常是模型文件路径配置不当或文件确实不存在导致的。
ComfyUI的模型路径在folder_paths.py中定义。例如，检查点模型的默认路径为models/checkpoints，如folder_paths.py#L23所示：folder_names_and_paths["checkpoints"] = ([os.path.join(models_dir, "checkpoints")], supported_pt_extensions)。
解决方案：
- 确认模型文件是否存在于正确的目录下。例如，检查点模型应放在
models/checkpoints文件夹中。 - 若使用自定义路径，可通过修改folder_paths.py或添加额外的模型文件夹路径来解决。参考folder_paths.py中的
add_model_folder_path函数，可添加自定义的模型路径。
CLIP模型无效
在使用CLIPTextEncode节点时，可能会遇到“ERROR: clip input is invalid: None”错误，如nodes.py#L72所示：raise RuntimeError("ERROR: clip input is invalid: None\n\nIf the clip is from a checkpoint loader node your checkpoint does not contain a valid clip or text encoder model.")。
这表明加载的检查点模型中不包含有效的CLIP或文本编码器模型。
解决方案：
- 确保使用的检查点模型完整，包含CLIP组件。
- 尝试重新加载其他已知有效的检查点模型，如使用CheckpointLoaderSimple节点加载正确的模型，其实现可参考nodes.py#L559中的
CheckpointLoaderSimple类。
网络与服务器错误
WebSocket连接异常
在使用WebSocket进行通信时，可能会出现连接错误，如server.py#L49中记录的警告：logging.warning("send error: {}".format(err))。
解决方案：
- 检查网络连接是否正常，确保服务器正在运行。
- 确认客户端与服务器的通信端口是否正确，默认情况下，ComfyUI的Prompt Server会监听相应端口，可在server.py的相关配置中查看。
- 若使用浏览器访问，清除浏览器缓存或尝试使用其他浏览器。
请求主机与源不匹配
当服务器收到主机与源不匹配的请求时，会返回403错误，如server.py#L131所示：logging.warning("WARNING: request with non matching host and origin {} != {}, returning 403".format(host_domain, origin_domain))。
这是出于安全考虑的措施，防止跨站请求伪造。
解决方案：
- 确保请求的主机和源一致，避免跨域请求。
- 若需要允许跨域请求，可在启动ComfyUI时添加
--enable-cors-header参数，并指定允许的源。
节点执行错误
节点输入无效
在执行节点时，若输入参数无效，可能会导致错误。例如，ConditioningAverage节点在conditioning_from包含多个条件时会发出警告，如nodes.py#L104：logging.warning("Warning: ConditioningAverage conditioning_from contains more than 1 cond, only the first one will actually be applied to conditioning_to.")。
解决方案：
- 检查节点的输入参数，确保符合节点的要求。例如，ConditioningAverage节点的
conditioning_from应只包含一个条件。 - 参考节点的文档或代码注释，了解正确的输入格式和限制。
自定义节点导入失败
当导入自定义节点时，若出现错误，会在日志中记录警告，如nodes.py#L2205：logging.warning(f"Cannot import {module_path} module for custom nodes: {e}")。
解决方案：
- 检查自定义节点的代码是否存在语法错误或依赖问题。
- 确保自定义节点的文件结构正确，且包含
NODE_CLASS_MAPPINGS或NODES_LIST，如nodes.py#L2202所述：logging.warning(f"Skip {module_path} module for custom nodes due to the lack of NODE_CLASS_MAPPINGS or NODES_LIST (need one).")。 - 若缺少依赖，可根据错误提示安装相应的依赖包，如运行
pip install -r requirements.txt。
内存相关错误
虽然未直接搜索到“CUDA out of memory”等内存相关错误，但在使用过程中可能会遇到此类问题。
解决方案：
- 降低生成图像的分辨率或批次大小，减少内存占用。
- 尝试使用更小的模型或优化模型加载方式，如使用模型裁剪、量化等技术。
- 关闭其他占用大量内存的应用程序，为ComfyUI腾出更多内存。
总结
本手册介绍了ComfyUI中常见的模型加载错误、网络与服务器错误、节点执行错误等问题，并提供了相应的解决方案。在遇到错误时，可先查看日志文件或控制台输出，根据错误信息定位问题所在，并参考本手册提供的方法进行解决。若问题仍未解决，可查阅ComfyUI的官方文档或寻求社区支持。
通过合理配置模型路径、检查输入参数、确保网络通信正常等措施，可有效减少错误的发生，提高ComfyUI的使用体验。同时，定期更新ComfyUI及相关依赖，也有助于修复已知的bug和问题。
【免费下载链接】ComfyUI 最强大且模块化的具有图形/节点界面的稳定扩散GUI。 项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
