故障排查GitHub issue2 分钟阅读故障排查

解决FastGPT HTTP模块的返回格式与参数传递异常问题

1. HTTP模块无法接收IMG格式的返回信息。 2. HTTP模块的反馈信息仅支持单字段独立接收,无法定义多字段共用一个出参口。 3. 当HTTP模块返回JSON格式数据,提取指定key(如示例数据中的data)后得到的JSON对象,无法被其他模块的入参接收。

现象

  1. HTTP模块无法接收IMG格式的返回信息。
  2. HTTP模块的反馈信息仅支持单字段独立接收,无法定义多字段共用一个出参口。
  3. 当HTTP模块返回JSON格式数据,提取指定key(如示例数据中的data)后得到的JSON对象,无法被其他模块的入参接收。示例数据为:{"message": "message", "data": {"name": "name", "age": 10}}。

可能原因

  1. HTTP模块未适配IMG格式的返回信息接收逻辑。
  2. HTTP模块的出参配置规则限制,仅支持单字段绑定,不支持多字段聚合共用出参。
  3. 从JSON数据中提取的对象类型参数,未自动转换为字符串格式,无法适配其他模块的入参要求。

排查步骤

  1. 核对HTTP模块的返回格式配置,确认是否覆盖IMG类型的接收设置。
  2. 查看HTTP模块的出参绑定配置,确认是否仅支持单字段独立接收,无法实现多字段共用出参。
  3. 提取JSON数据中的指定key对应的数据后,验证参数类型是否为非字符串格式。

解决与验证

针对上述问题,可参考以下处理方式:

  1. 针对IMG格式返回的接收问题,确认模块是否支持该格式,或按需求添加格式转换适配逻辑。
  2. 调整HTTP模块的出参配置,实现多字段共用一个出参口的设置。
  3. 为提取的非字符串参数添加自动转换为字符串的处理,可参考指定回复模块的中转逻辑。

验证时,配置完成后依次测试HTTP模块接收IMG格式返回、多字段共用出参、JSON对象参数传递的功能,确认功能正常。

来源: FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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