解决FastGPT私有部署版头像上传访问异常问题

现象

FastGPT v4.13.2私有部署版本中，调用/api/common/file/getAvatarPresign接口会返回minio的地址与参数。前端发起该接口请求后，无法正常访问返回的minio资源。进入账号-个人信息页面点击头像上传后，头像无法正常修改。

可能原因

该头像处理逻辑为v4.13.2版本新增，接口返回的minio地址未适配私有部署环境的访问限制，导致前端无法直接访问minio服务。具体配置调整需按实际部署环境确认。

排查步骤

1. 确认当前使用的FastGPT版本为v4.13.2私有部署版。
2. 调用/api/common/file/getAvatarPresign接口，查看返回内容是否包含minio的地址与参数。
3. 验证前端运行环境是否可以直接访问返回的minio地址。
4. 核对本地配置文件是否与项目最新代码保持一致。

解决与验证

检查minio服务的访问权限相关配置，确保前端可以通过合法路径访问资源。若本地配置文件与项目最新代码一致，则需按实际部署环境调整相关配置。重新上传头像后，确认头像可以正常加载显示，即可完成验证。

来源： FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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