该技能聚焦 n8n v1.x 工作流中的表达式错误诊断与修复,主要用途是在表达式求值失败或出现未定义引用时快速定位原因并给出修复方法。
主要能力包括:提供快速诊断表,将症状映射到原因与修复方式,如 undefined 字段、TypeError、$itemIndex 未定义、$secrets 未定义、$response 上下文错误、Paired item 未找到、JMESPath 结果异常、空字符串、静态数据为空、类型函数错误、项目链接错误、Python 属性错误、分页变量未定义、数字字符串比较、日期比较失败等。提供变量可用性矩阵,说明 $json、$input、$("<Node>").item、$itemIndex、$secrets、$env、$vars、$now、$execution、$response、$pageCount 等变量在表达式字段、Code 节点(JS/Python)、HTTP Request 节点中的可用性。提供决策树,按变量可用性、字段存在性、空值、类型、项目链接逐步排查。还包含 Paired Item 错误处理、JMESPath 参数顺序说明、静态数据注意事项、常见错误消息参考、Code 节点限制、$response 上下文限制、空值处理策略和类型转换速查表。
使用方式:按症状查阅诊断表,结合变量可用性矩阵确认当前上下文是否支持所用变量,按决策树逐项排查,参考错误消息表和类型转换表修正表达式。对于 Code 节点,注意 $itemIndex、$secrets 不可用,Python 使用括号访问,避免在 Code 节点发起 HTTP 请求或访问文件系统。
适用场景:n8n 工作流表达式调试、Code 节点逻辑修正、数据访问异常排查、HTTP Request 节点响应处理、静态数据使用问题定位。
限制:资料未提供安装命令、价格、平台支持范围或效果保证;部分修复方式依赖具体工作流上下文,需结合实际数据验证。