现象
私有部署版本V4.94的FastGPT完成版本更新后，对话功能无法正常使用。API密钥的渠道测试环节均显示正常，但发起对话时触发报错信息：Reached the max retries per request limit (which is 20). Refer to "maxRetriesPerRequest" option for details.
可能原因
当前问题反馈中未明确给出具体触发原因，仅明确报错为请求重试次数达到上限。该报错的具体触发场景需结合实际部署环境、请求链路等信息进一步确认，无额外可推断的关联原因。
排查步骤
- 确认FastGPT为V4.94私有部署版本，且已完成完整的版本更新操作。
- 验证当前使用的API密钥的可用性，确认渠道测试环节无异常表现。
- 查看对话请求相关的完整日志，提取并核对报错信息是否与给定的重试上限报错一致。
- 参考报错提示中的maxRetriesPerRequest选项，核对该配置项的当前设置值。
解决与验证
根据报错提示，可调整maxRetriesPerRequest配置项的数值，具体的配置文件路径与修改方式需按实际部署环境确认。完成配置修改后，重启FastGPT服务，发起对话测试，确认对话功能恢复正常且未再触发重试上限报错。同时需保留原配置的备份，以便后续根据实际需求调整参数。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。