扣子工作流（Coze工作流）运行过程中突然出现异常？上一步明明显示绿色对勾表示通过，下一步却直接亮起红色报错，控制台仅抛出两句冰冷的“类型错误”或“变量未定义”提示。先别急着怀疑节点本身存在故障——问题大概率不在节点内部，而是数据在节点间传递流转时，悄然改变了原本的结构或类型。

精准定位错误源头：切勿直接修改报错节点

先别着急，点击报错节点右侧那个「详情」按钮，将完整的错误信息展开仔细查看。如果看到类似 "Cannot read property 'xxx' of null" 或 "undefined is not an object" 这样的提示，说明该节点接收到的要么是一个空值，要么是完全无法识别的数据结构。

此时千万不要直接去调整这个报错节点。正确的排查思路是：向上追溯，点击它的上一个节点，打开「详情」→ 查看「输出」部分究竟输出了什么内容。重点核对三件事：字段名称是否拼写完全一致、嵌套层级是否被意外展平或丢失、拿到的值是否为 【null】 或空字符串。

这就好比身体不适去看医生，不能只盯着疼痛的部位，而要找到真正的病灶。

校验上游输出类型与下游输入要求是否匹配

方法一：直接在节点配置面板中进行验证。选中上游节点 → 点击右上角那个「设置」图标 → 展开「输出变量」区域。仔细确认你引用的那个字段（比如 user_info），它标注的类型是 Object 还是 String。如果下游节点期望接收 Object，而这里显示的却是 String，那中间就必须额外添加一个解析转换步骤。

方法二：更专业的做法是，在报错节点前面插入一个代码节点，添加一行诊断输出：
console.log("上游输出类型:", typeof input_data, "原始值:", input_data);
运行一次并查看控制台打印的内容。如果显示 string，但下游需要的是数组类型，那么问题的根源就锁定了。

这里必须强调一个经常被忽略的关键前提：大模型节点的输出永远都是 String 类型，哪怕你在 Prompt 中编写了格式再规范的 JSON 也不例外。可以毫不夸张地说，90%的“取不到字段”问题，根源都出在这里。

纠正变量引用路径错误

第一步：打开下游节点的输入配置界面。找到你填写变量的位置（比如大模型节点的「系统提示词」输入框），确认你是否直接手动敲入了变量名称（例如 user_intent）。

第二步：删除手写的内容，点击输入框右侧那个 {} 按钮。从弹出的变量选择器中，逐层展开上游节点，找到对应的目标字段，直接点击插入。这样自动生成的引用路径类似于 {{llm_1.output.user_intent}}，这种写法能有效避免人为拼写错误。

第三步：仔细核验路径中的每一个层级是否真实存在。例如 {{llm_1.output.data.items[0].title}}，你需要确认 data 不为 null、items 是一个数组且长度大于 0、title 字段确实存在。任何一个层级断裂，整个路径都会直接返回 undefined。

高效处理大模型输出的 JSON 字符串

在代码节点中粘贴以下标准解析模板：

try {
  const raw = llm_output;
  const cleaned = raw.replace(/```json\s*/gi, '').replace(/```\s*/g, '').trim();
  const parsed = JSON.parse(cleaned);
  return { data: parsed };
} catch (e) {
  throw new Error(`JSON 解析失败: ${e.message}，原始内容: ${raw.substring(0, 100)}`);
}

这段代码会自动移除 Markdown 代码块包裹、清除首尾多余空格，如果解析失败还能抛出包含上下文的详细错误信息，让你一眼就能看出原始乱码的状况，调试起来效率极高。

注意循环节点内部变量的作用域问题

如果你在「循环」节点内部引用了循环外部定义的变量（比如开始节点传入的 base_url），那就要特别留意——你需要手动勾选「循环内可用」这个选项。具体操作是：进入循环节点设置 → 找到「变量传递」区域 → 将外部变量拖入「循环内可用变量」列表。如果不进行这一步，循环体内部将无法识别这个变量，任何引用都会变成 undefined。

这一步一旦遗漏，循环第一次执行也许还能靠缓存侥幸运行成功，但第二次迭代时就会直接崩溃，因为作用域问题要到第二次执行时才会真正暴露出来。