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

解决FastGPT私有部署聊天页面回复中途卡住的问题

私有部署FastGPT时,Web聊天页面与模型对话过程中,回复内容会中途卡住。刷新页面或切换对话再切回后,可发现回复已完整生成,仅前端页面出现卡住状态。分享链接页面对话也会出现卡住情况,但刷新页面无法恢复。部分场景下,从输入信息回车到回复断掉的时间约为15秒。 问题可能来自两方面。

现象

私有部署FastGPT时,Web聊天页面与模型对话过程中,回复内容会中途卡住。刷新页面或切换对话再切回后,可发现回复已完整生成,仅前端页面出现卡住状态。分享链接页面对话也会出现卡住情况,但刷新页面无法恢复。部分场景下,从输入信息回车到回复断掉的时间约为15秒。

可能原因

问题可能来自两方面。一是上游链路或网络稳定性不足,涉及API密钥、网关等环节。二是网关超时设置过短,无法支撑较长时间的回复生成。此外,疑似存在前端硬编码的超时参数限制。

排查步骤

  1. 检查网关超时配置,确认当前设置时长。
  2. 验证上游API密钥及整体网络链路的稳定性。
  3. 排查前端代码中的超时参数,确认是否存在硬编码的时间限制。
  4. 分别测试普通聊天页面与分享链接页面的交互表现,区分两类场景的差异。

解决与验证

将网关超时参数调整至48000毫秒(8分钟),可覆盖多数长回复场景。若为本地Docker部署,需确认配置文件或容器内的超时设置。部分用户提到疑似存在pdf.js中的EXECUTION_TIME参数,但容器内未找到该文件,相关配置需按实际环境确认。验证时,发起需要较长生成时间的对话,观察页面是否不再中途卡住,且刷新后无需补全完整回复。

来源: FastGPT GitHub issue #234