---

name: n8n-validation-expert description: "解读和修复 n8n 验证错误的专家指南。" risk: unknown source: community

n8n 验证专家

解读和修复 n8n 验证错误的专家指南。

何时使用

• 你需要解读或修复 n8n 工作流中的验证错误。
• 任务涉及 missing_required、invalid_value、表达式失败或迭代验证-修复循环。
• 你需要工作流验证输出的具体修复指导。

---

验证理念

尽早验证，频繁验证

验证通常是迭代的：

• 预期会有验证反馈循环
• 通常需要 2-3 次验证 → 修复循环
• 平均：23 秒思考错误，58 秒修复

关键洞察：验证是一个迭代过程，不是一次性的！

---

错误严重级别

1. 错误（必须修复）

阻止工作流执行 - 必须在激活前解决

类型：

• 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. 警告（应该修复）

不阻止执行 - 工作流可以激活但可能有问题

类型：

• best_practice - 推荐但非必需
• deprecated - 使用旧 API/功能
• performance - 潜在性能问题

示例：

{
  "type": "best_practice",
  "property": "errorHandling",
  "message": "Slack API can have rate limits",
  "suggestion": "Add onError: 'continueRegularOutput' with retryOnFail"
}

3. 建议（可选）

锦上添花 - 可以增强工作流的改进

类型：

• optimization - 可以更高效
• alternative - 实现相同结果的更好方式

---

验证循环

遥测数据中的模式

7,841 次出现此模式：

1. 配置节点
   ↓
2. validate_node（23 秒思考错误）
   ↓
3. 仔细阅读错误消息
   ↓
4. 修复错误
   ↓
5. 再次 validate_node（58 秒修复）
   ↓
6. 重复直到有效（通常 2-3 次迭代）

示例

// Iteration 1
let config = {
  resource: "channel",
  operation: "create"
};

const result1 = validate_node({
  nodeType: "nodes-base.slack",
  config,
  profile: "runtime"
});
// → Error: Missing "name"

// Iteration 2
config.name = "general";

const result2 = validate_node({
  nodeType: "nodes-base.slack",
  config,
  profile: "runtime"
});
// → Error: Missing "text"

// Iteration 3
config.text = "Hello!";

const result3 = validate_node({
  nodeType: "nodes-base.slack",
  config,
  profile: "runtime"
});
// → Valid!

这是正常的！ 不要因为多次迭代而气馁。

---

验证配置文件

根据你的阶段选择正确的配置：

minimal

使用场景：编辑期间的快速检查

验证内容：

• 仅必填字段
• 基本结构

优点：最快，最宽松 缺点：可能遗漏问题

runtime（推荐）

使用场景：部署前验证

验证内容：

• 必填字段
• 值类型
• 允许的值
• 基本依赖关系

优点：平衡，捕获真实错误 缺点：某些边缘情况可能遗漏

这是大多数用例的推荐配置

ai-friendly

使用场景：AI 生成的配置

验证内容：

• 与 runtime 相同
• 减少误报
• 对小问题更宽容

优点：对 AI 工作流噪音更少 缺点：可能允许一些有问题的配置

strict

使用场景：生产部署、关键工作流

验证内容：

• 所有内容
• 最佳实践
• 性能问题
• 安全问题

优点：最大安全性 缺点：警告多，可能有误报

---

常见错误类型

1. missing_required

含义：未提供必填字段

修复方法：

1. 使用 get_node 查看必填字段
2. 将缺失字段添加到配置中
3. 提供适当的值

示例：

// Error
{
  "type": "missing_required",
  "property": "channel",
  "message": "Channel name is required"
}

// Fix
config.channel = "#general";

2. invalid_value

含义：值不匹配允许的选项

修复方法：

1. 检查错误消息中的允许值
2. 使用 get_node 查看选项
3. 更新为有效值

示例：

// Error
{
  "type": "invalid_value",
  "property": "operation",
  "message": "Operation must be one of: post, update, delete",
  "current": "send"
}

// Fix
config.operation = "post";  // Use valid operation

3. type_mismatch

含义：字段的数据类型错误