工作流是 AIGCPanel Pro 版专属功能，在搭建与运行过程中可能会遇到无法启动、变量取不到值、节点报错等问题。本页汇总常见疑问与排查方法。
工作流无法运行？
按以下顺序检查：
- 确认使用的是 Pro 版，工作流为 Pro 版专属功能
- 确认存在开始节点，且有且只有一个，是所有链路的起点
- 检查是否有节点未连线或形成了断开的链路
- 点击编辑器顶部「运行」启动，观察哪个节点状态异常
变量取不到值？
${} 引用失效是最常见的问题，逐一排查：
- 检查
${节点标题.字段名} 中的节点标题与实际节点名称完全一致（含空格与大小写）
- 节点被重命名后，旧引用不会自动更新，需要手动修正
- 确认被引用的节点位于上游且已执行成功，失败节点不会产生输出
- 变量设置节点中的变量名拼写与引用处保持一致
详细语法见 工作流变量与数据引用。
某个节点报错怎么办？
- 找到状态为**失败（红色）**的节点，查看其错误信息
- 点击该节点查看输入数据，确认上游注入是否正常
- LLM 节点报错：检查大模型配置是否完整、模型服务是否可用
- MCP 工具调用节点报错：检查 MCP 服务配置与工具名称
- 文件类节点报错：确认路径存在、格式正确且有访问权限
节点执行顺序是怎样的？
- 工作流从开始节点出发，沿连线方向依次执行
- 没有连线关系的节点之间不存在依赖，不会互相等待
-
条件判断节点根据条件表达式决定走哪条分支，未选中的分支不会执行
- 上游节点失败时，其下游节点通常不会继续执行，先修复失败节点
如何提高搭建效率？
- 先用最少节点跑通核心链路，再逐步扩展
- 每添加一个节点就运行一次，参考 工作流调试与排错
- 会调整的参数（目录、模型名、数量等）统一放进变量设置节点
- 多复用 工作流实战案例 中的成熟链路模板
运行历史在哪里查看？
- 执行完成后点击任意节点，可查看该次运行的输入和输出数据
- 历史运行记录保存在工作流列表的执行历史中，可回看过往每次运行的详情
- 排查偶发问题时，可对比成功与失败两次运行的数据差异
相关文档
