PAYATHON 2026

在 n8n 中添加 OpenAI API key 时出错,该如何排查?

AI 小顾

结论

仅凭“粘贴 API key 后出现错误”,无法判断密钥是否无效。先确认错误出现在填写、保存或测试凭据时,还是执行 OpenAI 节点时,并取得完整错误信息。

建议先用只包含 OpenAI 调用的最小工作流测试,成功后再接回 LINE 和植物浇水流程。

先确认报错发生在哪一步

根据报错阶段选择排查方向:

  • 填写 API key 时立即报错:检查字段要求、复制的内容和表单提示。
  • 保存或测试凭据时报错:查看错误详情,确认是否涉及身份验证、权限或连接失败。具体测试行为取决于 n8n 版本和凭据类型。
  • 执行 OpenAI 节点时报错:除了密钥,还要检查模型选择、请求参数和服务端返回的信息。

记录错误时,保留状态码、错误类型和错误正文。不要在截图、日志或求助内容中公开 API key。

检查密钥和凭据配置

在与 OpenAI 节点匹配的凭据类型中填写密钥,并检查以下内容:

  1. 复制的是 OpenAI platform 生成的 API key,且没有截断。
  2. 密钥前后没有空格、换行或额外引号。
  3. 如果字段明确要求填写 API key,只填写密钥本身,不要自行添加 Bearer 或完整的 HTTP 请求头。
  4. OpenAI 节点实际选择了刚才创建的凭据。
  5. 如果配置过自定义 API 地址、代理或其他附加字段,确认这些设置符合当前连接方式,不要随意填写。

下面是字段内容示意,不是可导入的 n8n 配置,也不是真实密钥:

API Key 字段:<从 OpenAI platform 复制的完整 API key>

如果密钥已经公开,应撤销该密钥并创建新密钥,然后更新 n8n 中的凭据。

根据错误详情继续排查

如果错误中包含 HTTP 状态码,可以用它缩小排查范围,但仍应以错误正文为准:

错误表现 优先检查
401 或身份验证失败 密钥是否完整、有效,以及节点是否使用了正确凭据
403 或权限相关错误 密钥权限、项目权限和目标资源的访问限制
429 错误正文指向的是请求频率限制,还是额度相关限制
模型不可用或找不到模型 模型名称、访问权限和所用接口是否匹配
超时、DNS、TLS 或连接失败 运行 n8n 的环境能否连接目标服务,以及代理和证书设置

电脑浏览器能够打开某个网站,并不能证明运行 n8n 的服务器或容器也能连接对应 API。网络检查需要在实际运行 n8n 的环境中进行。

用最小工作流验证

先暂时简化输入,用固定文本测试 OpenAI 节点,例如:

请回复:连接成功

测试通过后,再逐步恢复原流程:

LINE 输入植物名称和地区
→ 整理输入
→ 获取天气数据(如需实际天气)
→ 调用 OpenAI
→ 将回答发送回 LINE

如果最小测试失败,继续检查凭据和 OpenAI 节点的错误详情;如果测试成功,再检查 LINE 输入、字段映射和回复环节。

天气数据需要单独确认

如果希望回答依据某地的实际天气,需要确认工作流提供了天气数据,或配置了能够获取天气的工具。仅传入地区名称,不能据此认定模型已经取得当地天气。

浇水建议还受植物品种、盆土、盆器和当前湿度影响。原问题没有提供这些信息,不能据此给出可靠的固定浇水量。

请补充完整错误文本、报错阶段、n8n 版本和节点类型,以便确定下一步应修改哪项配置。

备注:内容仅供参考。