排查 ComfyUI 连接和生成失败

开始前准备

保留当前错误原文、工作流名称和任务状态。先改一个条件再重试，避免同一问题连续提交。问题截图中应遮住密钥、令牌和不需要公开的服务信息。

操作步骤

1 检查服务连接

在服务地址页测试 ComfyUI。服务查询失败时，先查主机、端口和服务是否正在运行。另一台机器不能使用本机 localhost。

“服务查询成功，但网站拒绝任务提交”表示查询和提交链路不同。按错误提示检查并更新网站服务，再刷新测试，不能只靠 ComfyUI 首页可打开来判断。

2 检查导入格式

确认导入的是 API 图，节点带 class_type 和 inputs。带 nodes 数组的界面格式需要回到 ComfyUI 重新导出。重名导入时换一个新名称。

3 检查节点和模型

遇到未安装节点、缺少必填参数或模型不在可用列表，回到 ComfyUI 核对自定义节点版本和准确模型文件名。先跑通最小图，再回画布尝试。

默认模型名只是一项配置，不能说明文件已安装。不要随意换成不兼容模型来绕过错误。

4 检查素材与输出

参考素材为空或读取失败时，重新连接实际文件。工作流结束却没有图片、视频或文本时，检查橙色输出标记和图中保存节点，保存配置后回画布刷新。

H3 需要真正保存视频的输出节点。只有封面图片不能作为视频生成成功的依据。

5 检查原任务状态

断线时先恢复查询原任务。“远端任务已不存在”可能是服务重启或任务被停止。等待超时不能证明远端已取消。

通用面板“再次运行”会创建独立任务；H3 的停止请求也需等待远端确认。确认原任务后再用保留的草稿重新提交。

确认完成

同一个小任务能完整提交并返回可查看或播放的结果，错误已消失，输出类型与数量正确。

遇到问题

若仍失败，整理最小可复现工作流、节点和模型版本、错误原文及发生环节，再定位具体依赖。保留自己的原工作流；不要通过删除全部任务或全局停止来排查单个节点。