解决FastGPT /api/v1/chat/completions接口流式输出重复问题

现象

使用FastGPT私有部署版本V4.9.12，调用/api/v1/chat/completions接口且配置stream=true、detail=true时，返回的流式输出内容存在重复。该问题表现为流式返回的每个数据块中存在重复的文本片段，或同一内容被多次推送，相关截图可佐证该问题。

可能原因

暂未明确具体触发逻辑，可能与流式响应的拼接逻辑、数据推送机制有关，需结合实际部署环境、调用链路细节进一步排查确认。

排查步骤

1. 确认调用的接口路径为/api/v1/chat/completions，且参数stream、detail均设置为true。
2. 核对FastGPT私有部署版本为V4.9.12，确保与问题发生时的版本一致。
3. 查看FastGPT后端服务的流式响应日志，定位重复内容的出现位置与频率。
4. 检查调用方的请求配置，确认无重复发送请求或请求重试的情况。
5. 核对接口返回的原始数据，确认重复内容是否来自后端服务本身。

解决与验证

目前无公开的通用修复方案。若排查后定位到具体触发原因，需基于原因进行针对性修复。验证方式为重新调用配置了stream=true、detail=true的/api/v1/chat/completions接口，确认输出内容无重复。

来源： FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。