故障排查GitHub issue3 分钟阅读排错/错误码

解决FastGPT私有部署调用OneAPI时的连接错误问题

使用Docker本地部署FastGPT,调用SealosIO一键部署的SQLite版本OneAPI。创建应用后发起聊天时,会出现长时间无响应,随后抛出Connection error报错。OneAPI平台未生成新增的调用日志,说明FastGPT发起的请求未到达OneAPI服务。

现象

使用Docker本地部署FastGPT,调用SealosIO一键部署的SQLite版本OneAPI。创建应用后发起聊天时,会出现长时间无响应,随后抛出Connection error报错。OneAPI平台未生成新增的调用日志,说明FastGPT发起的请求未到达OneAPI服务。该问题并非必然发生,存在偶尔调用成功的情况。

可能原因

结合问题表现与配置信息,可能的诱因包括:FastGPT容器与OneAPI服务的网络连通稳定性不足,导致请求超时或中断;FastGPT未配置合理的请求超时时长,在长对话或慢响应场景下触发超时错误;配置文件中的OPENAIBASEURL或CHATAPIKEY存在隐性格式偏差,虽偶尔匹配成功但多数情况下无法完成正常请求。

排查步骤

  1. 进入FastGPT容器内部,执行curl命令测试OneAPI服务地址的连通性,命令示例为curl -v [替换为实际的OPENAI_BASE_URL地址] -H "Authorization: Bearer [替换为实际的CHAT_API_KEY]",查看返回的报错信息。
  2. 查看FastGPT容器的运行日志,执行docker logs fastgpt,检索是否存在连接超时、请求失败的详细报错内容。
  3. 核对docker-compose配置文件中的OPENAIBASEURL参数,确认地址末尾带有/v1后缀,且无多余空格或错误字符。
  4. 检查CHATAPIKEY的配置内容,确认密钥无遗漏、多余字符,与OneAPI平台生成的密钥一致。
  5. 确认FastGPT容器与OneAPI服务所在的网络环境是否互通,调整网络配置确保连通性正常。

解决与验证

  1. 修复网络连通问题:若测试发现容器无法访问OneAPI服务,需调整网络配置,确保FastGPT容器可以正常连通OneAPI地址。
  2. 修正配置错误:将OPENAIBASEURL和CHATAPIKEY调整为与实际服务匹配的正确内容,删除配置中的多余字符或空格。
  3. 调整请求超时配置:结合实际业务场景,添加或修改FastGPT的请求超时参数,设置合理的超时时长。
  4. 验证效果:重新启动FastGPT服务,发起多轮聊天测试,确认不再出现Connection error报错,同时OneAPI平台生成对应的调用日志,多次测试后调用成功率稳定。

来源:FastGPT GitHub issue