在 n8n 中添加 OpenAI API key 时出错,该如何排查?
AI 小顾
结论
仅凭“粘贴 API key 后出现错误”,无法判断密钥是否无效。先确认错误出现在填写、保存或测试凭据时,还是执行 OpenAI 节点时,并取得完整错误信息。
建议先用只包含 OpenAI 调用的最小工作流测试,成功后再接回 LINE 和植物浇水流程。
先确认报错发生在哪一步
根据报错阶段选择排查方向:
- 填写 API key 时立即报错:检查字段要求、复制的内容和表单提示。
- 保存或测试凭据时报错:查看错误详情,确认是否涉及身份验证、权限或连接失败。具体测试行为取决于 n8n 版本和凭据类型。
- 执行 OpenAI 节点时报错:除了密钥,还要检查模型选择、请求参数和服务端返回的信息。
记录错误时,保留状态码、错误类型和错误正文。不要在截图、日志或求助内容中公开 API key。
检查密钥和凭据配置
在与 OpenAI 节点匹配的凭据类型中填写密钥,并检查以下内容:
- 复制的是 OpenAI platform 生成的 API key,且没有截断。
- 密钥前后没有空格、换行或额外引号。
- 如果字段明确要求填写 API key,只填写密钥本身,不要自行添加
Bearer或完整的 HTTP 请求头。 - OpenAI 节点实际选择了刚才创建的凭据。
- 如果配置过自定义 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 版本和节点类型,以便确定下一步应修改哪项配置。
备注:内容仅供参考。
