ComfyUI「工作流草稿保存失败」修复指南

如果你搜索了 ComfyUI failed to save workflow draft，或界面显示 Failed to Save Workflow Draft，请在节点图仍可见时立即导出工作流 JSON。将 PNG 元数据视为有用的备份，而非唯一副本。

本页专门针对 GSC 精确查询 comfyui "failed to save workflow draft"。除非另有堆栈跟踪说明，否则这不是插件导入失败、模型缺失错误或 Manager 注册表错误。

如果界面只显示 Failed to fetch，但你不确定是不是 workflow draft、server logs、Manager 或 WebSocket，请先看 ComfyUI "Failed to Fetch"。

保存 ComfyUI 工作流与保存图片不同。图片是你的输出结果。工作流是生成它的节点图：包括节点、连线、提示词、模型选择和界面状态。

快速解答

如果只记住一条规则，记住这条：当工作流很重要时，同时保存 JSON 和输出 PNG。

精确错误日志

如果你的浏览器或控制台显示以下错误信息，请按照下方的紧急修复步骤操作：

Failed to Save Workflow Draft

Failed to Save Workflow Draft 紧急修复

如果在节点图仍可见时出现此错误，请在调试之前先保护工作流：

1. 立即使用另存为或导出工作流 JSON。
2. 如果工作流仍可运行，保存一张带元数据的输出 PNG。
3. 在刷新前复制浏览器错误文本或截图画布。

然后诊断草稿保存错误：

不要与插件导入或前端包错误混淆

GSC 显示此查询有时会落在插件导入和前端包页面上。请按以下方式区分：

用户容易混淆的三种工作流格式

1. 普通工作流 JSON

这是在 ComfyUI 界面中重新打开工作流的主要格式。它存储图的布局、节点、连线、控件、分组及相关界面信息。

在以下情况使用：

• 稍后重新打开工作流
• 将图发送给其他用户
• 保留版本化备份
• 调试缺失的自定义节点
• 在更改插件前保存可用状态

2. API 格式 JSON

API 格式不同。它专为通过 API、脚本和云系统进行程序化执行而设计。

在以下情况使用 API 格式：

• 通过 API 提交工作流
• 自动化生成
• 围绕 ComfyUI 构建工具
• 将工作流输入需要提示词 JSON 的服务

除非你确定工作流永远不会在普通 ComfyUI 界面中重新打开，否则不要将 API 格式作为唯一的可读备份。

3. PNG 元数据

SaveImage 节点将图片保存到 ComfyUI/output/。它可以将提示词和工作流元数据嵌入 PNG 文件中。

这很方便，因为你通常可以将生成的 PNG 拖回 ComfyUI 来恢复创建它的工作流。

但 PNG 元数据不是完整的备份策略：

• 元数据可能被图片优化器剥离
• 截图通常不保留工作流元数据
• 某些分享平台会删除元数据
• 视频工作流和非 PNG 输出的行为可能有所不同

对于重要工作，也请保留 JSON。

如果看到「Failed to Save Workflow Draft」

该措辞通常指向浏览器端状态、权限或前端会话中断，而非模型缺失。

这一具体诊断基于 ComfyUI 前端存储工作流状态方式的实践排查经验。官方 ComfyUI 文档直接记录了工作流 JSON、PNG 元数据和用户目录，但没有发布每种草稿保存失败的正式错误分类。

按顺序检查：

1. 首先手动将工作流保存为 JSON，以免丢失图。
2. 刷新页面并确认 ComfyUI 仍处于连接状态。
3. 在 http://127.0.0.1:8188 中禁用浏览器扩展进行测试。
4. 检查浏览器是否阻止了本地存储或文件访问。
5. 如果 ComfyUI 持续重连或其他界面操作也失败，继续查看 ComfyUI Reconnecting Error 或 ComfyUI Failed to Fetch Server Logs。

不要认为草稿保存问题意味着工作流本身已损坏。大多数情况下，更安全的做法是立即导出 JSON，然后再调试界面问题。

如何保存工作流

使用以下方法之一：

如果出现浏览器下载对话框，请选择清晰的文件夹，并根据工作流用途命名文件。

示例：

workflows/
  flux-kontext-product-photo-v1.json
  flux-kontext-product-photo-v2.json
  wan-video-test-lowvram.json

ComfyUI 将工作流保存在哪里

没有统一的答案，因为 ComfyUI 有多个保存路径。

手动 JSON 导出

如果你明确保存或导出了工作流 JSON，它会保存到你的浏览器或文件对话框所选的位置。许多用户不小心将这些文件留在了 Downloads 文件夹中。

检查：

C:\Users\<you>\Downloads

或你在保存对话框中选择的文件夹。

ComfyUI 用户目录

ComfyUI 还有一个用户目录，用于存储设置、工作流状态和用户特定数据。

对于 GitHub Windows 便携版安装，默认用户目录通常位于解压后的便携根目录下的 ComfyUI 文件夹中：

<your-portable-root>/ComfyUI/user/default

例如，如果解压后的便携文件夹是 D:\AI\ComfyUI_windows_portable，请检查：

D:\AI\ComfyUI_windows_portable\ComfyUI\user\default

该文件夹目前包含以下设置文件：

comfy.settings.json

根据你的 ComfyUI 版本以及通过 Workflows 侧边栏保存的方式，工作流状态和已保存的工作流文件也可能出现在用户目录下。将此目录视为有用的状态存储，但不要将其作为唯一备份。

生成的图片

输出图片通常保存到：

ComfyUI/output/

如果嵌入了工作流元数据，这些图片可以通过拖回 ComfyUI 用于恢复。

如何从图片中恢复工作流

如果你还有生成的 PNG：

1. 打开 ComfyUI。
2. 将 PNG 拖到画布上。
3. 如果元数据存在，ComfyUI 应该会加载工作流。
4. 立即将工作流保存为 JSON。
5. 清晰地重命名 JSON 并与项目一起保存。

如果拖入图片没有任何反应，元数据可能已被删除。请使用 ComfyUI/output/ 中的原始文件，而非来自聊天、社交媒体或网站的压缩副本。

更安全的工作流习惯

许多 ComfyUI 故障恰好发生在安装自定义节点、更新或模型清理之后。恢复最快的用户通常是那些在做任何更改之前就导出了干净 JSON 的人。

养成以下习惯：

1. 将可用的工作流保存为 JSON。
2. 在文件名中加入日期或变更说明，保存第二份副本。
3. 保留一张仍包含元数据的输出 PNG。
4. 记录所需的模型文件和自定义节点。
5. 然后再更新自定义节点、Python 包或 ComfyUI 本身。

最佳备份习惯

在安装自定义节点、更新 ComfyUI 或更改 Python 包之前：

1. 将当前工作流保存为 JSON。
2. 将重要的 JSON 文件复制到备份文件夹。
3. 如果输出图片包含有用的元数据，一并复制。
4. 记录所需的自定义节点和模型。
5. 测试 JSON 能否在干净的 ComfyUI 环境中打开。

一个简单的项目文件夹结构如下：

project-name/
  workflows/
    workflow-v1.json
    workflow-v2-before-plugin-update.json
  outputs/
    ComfyUI_00001_.png
  notes/
    required-models.txt
    required-custom-nodes.txt

为什么保存后工作流仍会失败

工作流 JSON 存储节点图结构。它不包含每个模型文件、自定义节点仓库或 Python 依赖项。

已保存的工作流稍后失败的常见原因：

• 模型文件缺失
• 检查点名称已更改
• LoRA 文件已移动
• 自定义节点未安装
• 自定义节点重命名了某个类
• Python 依赖项已更改
• 工作流以 API 格式保存，但作为界面工作流重新打开

这就是「已保存」和「可恢复」不是同一回事的原因。工作流文件保留了结构，但运行环境仍需与之匹配。

如果看到 Invalid image file

某些工作流存储了对输入图片、蒙版或上传文件的引用。将工作流迁移到另一台机器、清除浏览器状态或删除 ComfyUI 输入文件夹中的文件后，图可能会加载但在队列执行时失败：

Custom validation failed for node image
Invalid image file: silver_hand.png

这通常意味着工作流 JSON 完整，但某个引用的输入资源已丢失或无法读取。

按以下顺序修复：

1. 在命名该文件的节点中重新附加缺失的输入图片。
2. 如果节点需要之前上传的文件，检查 ComfyUI 的 input/ 文件夹。
3. 重命名或重新选择文件，而不是手动编辑 JSON。
4. 恢复缺失资源后，保存新的工作流 JSON。

对于便携版安装，相关输入文件夹通常位于解压便携包内的 ComfyUI 文件夹下。对于桌面版或托管启动器，请使用应用的文件管理路径，而不是假定便携版目录结构。

如果已保存的工作流打开后出现红色或未知节点，请使用 How to Fix ComfyUI Plugin Import Failed Errors。

对于更大规模的工作流设置，请使用 Workflow Environment Setup。

保存工作流 vs 保存图片

对于重要项目，两者都保存。

Wonderful Launcher 的作用

已保存的工作流只有在环境仍能运行它们时才有用。

当你需要保护或恢复以下内容时，Wonderful Launcher 非常有用：

• 工作流 JSON 文件
• 模型文件夹
• 自定义节点设置
• Python 依赖项
• 更新后损坏的 ComfyUI 环境

如果你有重要工作流，且环境在自定义节点操作后持续损坏，请在从头重建之前下载 Wonderful Launcher。

常见问题

我的 ComfyUI 工作流保存在哪里？

如果你导出了 JSON 文件，请检查你选择的文件夹或浏览器的下载文件夹。如果你使用了 Workflows 侧边栏或自动保存功能，请检查 ComfyUI 用户目录，便携版安装通常为 ComfyUI/user/default。

为什么 ComfyUI 没有保存我的工作流草稿？

通常是因为浏览器端状态失败、前端部分损坏，或本地会话失去了对运行服务器的访问。请先手动导出 JSON，然后再调试重连、前端或权限问题。

ComfyUI 工作流会保存在 PNG 图片中吗？

有时会。SaveImage 节点可以将工作流和提示词元数据嵌入 PNG 文件。如果元数据仍然存在，将 PNG 拖入 ComfyUI 可以重新加载工作流。

为什么我的 PNG 无法再加载工作流了？

元数据可能已被网站、聊天应用、图片优化器或截图工具删除。尽可能使用 ComfyUI/output/ 中的原始文件。

我应该保存工作流 JSON 还是 API 格式？

保存普通工作流 JSON 以便在界面中重新打开和编辑。只有在需要自动化或 API 执行时才保存 API 格式。

工作流 JSON 包含模型吗？

不包含。它可以引用模型名称和节点设置，但不打包检查点、LoRA、VAE 或自定义节点文件。

相关指南

• ComfyUI Interface Guide
• How to Group in ComfyUI
• ComfyUI Prompt Has No Outputs Fix
• ComfyUI Failed to Fetch Server Logs
• comfyui-frontend-package Not Installed or Frontend Version Outdated
• ComfyUI Missing Nodes, class_type, and Clean Library Entry Point Fix
• ComfyUI ControlNetApplyAdvanced class_type Fix
• Workflow Environment Setup
• Install Custom Nodes
• ComfyUI Plugin Import Failed

来源参考

• Official ComfyUI workflow concept
• Official workflow JSON schema
• Official SaveImage node documentation
• Official ComfyUI settings documentation
• Official ComfyUI appearance and user directory documentation