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

解决FastGPT 4.9.7版本webm格式文件上传报错问题

FastGPT 4.9.7版本中,上传webm格式音频文件时出现报错。日志显示WARNING:root:Uploaded file name: cmZe6eAUedCbDbxO.webm,随后抛出ERROR:root:400: Unsupported file format: .webm,接口返回500 I…

现象

FastGPT 4.9.7版本中,上传webm格式音频文件时出现报错。日志显示WARNING:root:Uploaded file name: cmZe6eAUedCbDbxO.webm,随后抛出ERROR:root:400: Unsupported file format: .webm,接口返回500 Internal Server Error。完整报错栈信息包含fastapi.exceptions.HTTPException: 400: Unsupported file format: .webm,请求路径为POST /v1/audio/transcriptions

可能原因

当前仅能基于报错信息推断,可能为4.9.7版本中音频转录接口的允许格式白名单未包含.webm格式,具体需按实际部署环境的配置确认。

排查步骤

  1. 查看服务日志,确认报错文本为400: Unsupported file format: .webm,且请求路径为/v1/audio/transcriptions
  2. 确认当前运行的FastGPT版本为4.9.7。
  3. 查找音频转录功能对应的格式白名单配置(具体配置路径需按实际环境确认)。
  4. 核对白名单列表中是否包含.webm格式。

解决与验证

若排查发现格式白名单未包含.webm,需将该格式添加至白名单配置中。重启FastGPT服务后,上传webm格式音频文件,验证是否不再抛出Unsupported file format: .webm报错,且接口可正常完成转录流程。

来源: FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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