Output Parser Randomly Failing After Most Recent Update – Function Calling Errors

快速结论：该报错通常出现在 n8n 工作流调用 Output Parser 节点、并配合 LLM（本例为 Gemini 模型）执行 function calling / 工具调用时，模型返回内容不符合解析器要求的格式，导致执行随机失败。优先排查模型是否正确触发工具调用，以及 Output Parser 的格式约束是否与模型实际输出匹配。

适用环境：n8n（Issue 报告为“most recent”版本，未给出精确版本号）、Node.js（同未给出精确版本号）、Windows、数据库 SQLite（默认）、执行模式 main（默认）、托管于 n8n cloud；使用 Gemini Flash 2.5 与 Gemini Pro 模型。

最快修复方案：暂无确认的一步修复方案。Issue 中验证过的缓解方式是：在根节点的 “On Error” 参数中改为继续执行，或对失败节点设置错误后重试；报告者反馈“设置错误后重试，通常 1-2 次后可以通过”。

注意事项：重试只是绕过随机失败，并非根因修复；报告者和维护者均怀疑该问题可能与 Gemini 模型的工具调用行为有关（“there were some issues with Gemini models not properly calling tools”），维护者建议在较新版本中重新确认。该 Issue 因 3 个月无活动被关闭，未给出最终确认的修复结论。

问题场景

用户在 n8n 中运行包含 Output Parser 节点的工作流，并使用 Gemini 模型（Gemini Flash 2.5 和 Pro 均测试过）执行 function calling / 工具调用。工作流此前长期稳定运行，在最近一次 n8n 更新后开始出现间歇性失败：同一个工作流有时成功、有时失败，且没有固定的触发规律。报告者表示这已经阻塞了生产工作流。

报错原文

N8N Error

Model output doesn't fit required format
To continue the execution when this happens, change the 'On Error' parameter in the root node's settings

原因分析

最直接的报错含义是：LLM 的输出没有满足 Output Parser 节点所要求的格式，因此解析失败。

结合 Issue 讨论，可能原因包括：

Gemini 模型未能正确完成工具调用（function calling），导致返回内容结构与解析器预期不一致。维护者在评论中明确提到“there were some issues with Gemini models not properly calling tools”。
报告者怀疑是最近版本引入的回归，并提出可能存在竞态条件或解析逻辑变更，但这属于报告者的推测，Issue 中未提供代码层面的证据。
维护者指出，由于错误是间歇性的，也可能来自 n8n 外部，例如 LLM 侧的行为变化（“could be a problem external to n8n like maybe an LLM change”）。

需要注意的是，Issue 中没有给出精确版本号，也没有最终定位到具体代码改动，因此无法确认根因。

环境排查

确认 n8n 的精确版本号：报告者只写了“most recent”，维护者明确要求提供“exact version numbers”，这一点在原 Issue 中始终未补充。
确认 Node.js 的精确版本号：报告中同样只写“most recent”。
确认使用的模型：本例为 Gemini Flash 2.5 与 Gemini Pro，两者均出现随机失败。
确认操作系统为 Windows、数据库为 SQLite（默认）、执行模式为 main（默认）、托管方式为 n8n cloud。
确认 Output Parser 节点所配置的输出格式约束，以及该格式是否与模型实际返回结构一致。
确认是否只在涉及 function calling / 工具调用的分支中出现，普通 LLM 输出是否正常。
确认同一工作流在不同时间重复执行时，失败是否随机分布。

解决步骤

先记录失败时 n8n 的精确版本号和 Node.js 版本号，便于排查是否为特定版本的回归。
导出或构造一个最小可复现工作流：仅保留 LLM 节点 + Output Parser 节点，并启用 function calling，用于确认问题是否与业务逻辑无关。报告者提供的复现工作流附件为 LLC SEO Setup.json。
先切换到单一模型（如仅 Gemini Flash 2.5）反复执行，再切换到 Gemini Pro 重复测试，确认失败是否与特定模型相关。
在根节点的 “On Error” 参数中设置为继续执行，或在失败节点上启用错误后重试；报告者反馈重试通常 1-2 次即可通过，可用于临时恢复生产工作流。
将 n8n 升级到较新版本后重新验证，因为维护者提到 Gemini 工具调用相关问题“should hopefully be fixed by now”。
如果问题在较新版本中仍然存在，建议附上最小复现工作流和精确版本号重新开启 Issue 或提交新 Issue。

验证方法

在应用上述缓解措施后，连续多次运行同一工作流，观察 Output Parser 是否还会间歇性抛出 “Model output doesn’t fit required format”。如果开启重试后工作流可以稳定完成、且不再中断执行，说明缓解措施生效；但只有在升级到较新版本后且不再需要重试也能稳定通过时，才可以认为根因问题已经解决。由于该 Issue 已关闭且没有最终确认的修复结论，建议以持续观察为准。