配置 n8n 节点参数时如何按操作类型确定必填字段并渐进式发…

在 n8n 中配置节点参数时，根据 resource+operation 确定必填字段、理解字段依赖与可见性，并通过验证驱动迭代完成配置。

适用场景

解决思路

1. 先用 get_node 且使用默认的 detail: "standard"（约 1-2K tokens），它覆盖 95% 的配置需求；不要一上来就用 detail: "full"（3-8K tokens）。
2. 识别节点类型与 operation，因为 resource + operation 共同决定哪些字段必填（例如 Slack post 需要 channel+text，update 需要 messageId+text 且不需要 channel）。
3. 按标准流程操作：识别节点类型与操作 → 用 get_node（默认 standard）→ 配置必填字段 → 验证配置 → 字段不明确时用 get_node({mode: "search_properties"}) → 按需添加可选字段 → 再次验证 → 部署。
4. 采用验证驱动的循环：从最小配置开始（如 HTTP 的 method、url、authentication），让每次 validate_node 报错暴露下一个必填字段（POST 需要 sendBody，sendBody=true 时需要 body），直到通过。
5. 理解 displayOptions 可见性规则：show/hide 块中多个条件为 AND、多个值为 OR（如 body 在 sendBody=true 且 method IN (POST, PUT, PATCH) 时显示）。
6. 掌握三类常见依赖模式：布尔开关（sendBody → body）、操作切换（post 与 update 显示不同字段）、类型选择（string 与 boolean 条件）。
7. 当验证提示某个看不到的字段时，用 get_node({mode: "search_properties", propertyQuery: "..."}) 或 get_node({detail: "full"}) 查找控制该字段可见性的属性。
8. 遇到 standard 详情中标记为 dynamicOptions: {methodName, methodType, dependsOn} 的动态属性时，不要猜测 ID，改用 n8n_explore_node_resources 解析（需 N8N_MCP_ACCESS_TOKEN、n8n 2.34+），并把返回的 value 填入配置（name 只是显示文本）。
9. 调用 n8n_explore_node_resources 时六个参数全部必填且互不推断：nodeType（长格式）、version（该方法的 typeVersion）、methodName（从 dynamicOptions 原样复制，区分大小写）、methodType（资源定位器用 "listSearch"，普通下拉用 "loadOptions"）、credentialType、credentialId（来自 n8n_manage_credentials({action: "list"})）、currentNodeParameters（按 dependsOn 指定的参数，资源定位器值保持 {__rl: true, mode, value} 形状）。
10. 按节点模式配置：Resource/Operation 节点（Slack、Google Sheets、Airtable）先选 resource 再选 operation，再用 get_node 查看该操作的要求；HTTP 类节点注意 POST/PUT/PATCH 才有 sendBody、sendBody=true 需要 body、authentication != "none" 需要凭证；数据库节点按 operation 决定 query/table+values/where；条件逻辑节点区分二元运算符（需 value1+value2）与一元运算符（只需 value1 且 singleValue: true）。
11. HTTP 类节点配置时：不要设置占位凭证 ID（如 "REPLACE_ME"），未知真实 ID 时直接省略 credentials 块；节点 id 必须是 UUID v4 而非可读 slug；不要硬编码旧的 typeVersion，用 get_node 核实当前版本（httpRequest 为 4.4+）。
12. 数据库写操作（INSERT/UPDATE/DELETE）可能返回 0 个 item：在写操作节点上设置 alwaysOutputData: true 以保持下游链路存活，下游节点如需数据应使用 $('UpstreamNode').all() 而非 $input。
13. SplitInBatches v3 配置 batchSize 与 options，并正确接线：main[0]（done）接下游处理（先加 Limit 1），main[1]（each batch）接循环体再回到 SplitInBatches 输入。
14. Google Sheets 节点注意逐项执行：每个输入 item 触发一次 API 调用，批量写入应先用 Code 节点聚合再用单个 HTTP Request 调 Sheets API；含公式列的表不要用 append（会覆盖公式），改用 HTTP Request 调 Google Sheets API 的 values.update（PUT）配合 googleApi 凭证。
15. 需要修改节点字段中的某段字符串而非整体替换时，用 n8n_update_partial_workflow 的 patchNodeField 操作（如改 Code 节点的 jsCode、大段 HTML 邮件模板中的 URL、JSON body 中的拼写错误），传入 nodeName、fieldPath 和 patches 数组（find/replace）。
16. patchNodeField 是严格模式：find 字符串找不到或匹配多处会报错（除非 replaceAll: true），这能防止配置更新时静默失败。
17. 避免过度配置：不要预先添加所有可选字段（如 sendQuery、sendHeaders、sendBody、timeout 等），从最小配置开始按需添加。
18. 不要跳过验证：配置后先调用 validate_node，valid 后再用 n8n_update_partial_workflow 部署。
19. 不要忽略操作上下文：切换 operation 时必须重新用 get_node 检查要求，不要沿用旧配置的字段。
20. 迭代验证是正常的：配置 → 验证 → 修复 → 重复，平均 2-3 轮。
21. 信任自动清理（auto-sanitization）：运算符结构会自动修复，不要手动增删 singleValue，IF/Switch 元数据在保存时自动添加。
22. 警惕静默失败陷阱：Switch 未设 options.fallbackOutput 会静默丢弃未匹配项；Merge 的 numberOfInputs 默认 2（多余来源被丢弃）且 useDataOfInput 是 1 起始而 connections.<src>.main[idx] 是 0 起始（useDataOfInput: "N" 对应 main[N-1]）；数据库节点把 {{ }} 插值进 parameters.query 会造成 SQL 注入，应使用 $1/$2 占位符加 options.queryReplacement；Slack Block Kit 必须包成 ={{ { "blocks": ... } }} 否则按纯文本发送；Webhook/Respond 的 responseCode 默认 200 即使错误分支也是；Schedule Trigger 的时区是工作流级（Workflow Settings）而非每条规则。

适用边界 · 注意事项

• 不使用 n8n 或其 MCP 工具链时（本技能依赖 get_node、validate_node、n8n_update_partial_workflow、n8n_explore_node_resources 等工具）。
• 解析动态属性（dynamicOptions）需要 N8N_MCP_ACCESS_TOKEN 与 n8n 2.34+，缺少这些条件时无法用 n8n_explore_node_resources 获取真实值。
• 不适用于非 n8n 的节点配置系统或其他工作流引擎。