n8n-validation-expert

# n8n 验证专家 解读和修复 n8n 验证错误的专家指南。 --- ## 验证理念 **尽早验证，频繁验证** 验证通常是迭代式的： - 预期会有验证反馈循环 - 通常需要 2-3 次验证 → 修复周期 - 平均：23 秒思考错误，58 秒修复错误 **核心见解**：验证是一个迭代过程，而不是一次性修复！ --- ## 错误严重级别 ### 1. 错误 (Errors)（必须修复） **阻塞工作流执行** - 必须在激活前解决 **类型**： - `missing_required` - 未提供必填字段 - `invalid_value` - 值与允许的选项不匹配 - `type_mismatch` - 数据类型错误（字符串而非数字） - `invalid_reference` - 引用的节点不存在 - `invalid_expression` - 表达式语法错误 **示例**： { "type": "missing_required", "property": "channel", "message": "Channel name is required", "fix": "Provide a channel name (lowercase, no spaces, 1-80 characters)" } ### 2. 警告 (Warnings)（建议修复） **不阻塞执行** - 工作流可以激活，但可能存在问题 **类型**： - `best_practice` - 推荐但非强制 - `deprecated` - 使用了旧的 API/功能 - `performance` - 潜在的性能问题 **示例**： { "type": "best_practice", "property": "errorHandling", "message": "Slack API can have rate limits", "suggestion": "Add onError: 'continueRegularOutput' with retryOnFail" } ### 3. 建议 (Suggestions)（可选） **锦上添花** - 可以增强工作流的改进 **类型**： - `optimization` - 可以更高效 - `alternative` - 实现相同结果的更好方法 --- ## 验证循环 ### 基于遥测的模式 **7,841 次**该模式的出现： 1. 配置节点 ↓ 2. validate_node_operation (23 秒思考错误) ↓ 3. 仔细阅读错误信息 ↓ 4. 修复错误 ↓ 5. 再次 validate_node_operation (58 秒修复) ↓ 6. 重复直到有效 (通常 2-3 次迭代) ### 示例 javascript // 迭代 1 let config = { resource: "channel", operation: "create" }; const result1 = validate_node_operation({ nodeType: "nodes-base.slack", config, profile: "runtime" }); // → 错误: 缺少 "name" // ⏱️ 23 秒思考... // 迭代 2 config.name = "general"; const result2 = validate_node_operation({ nodeType: "nodes-base.slack", config, profile: "runtime" }); // → 错误: 缺少 "text" // ⏱️ 58 秒修复... // 迭代