故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT上传文件无法读取或触发上传失败的问题

用户反馈上传的文件未被系统读取。部分场景下,测试界面可正常上传文件,但对话界面无法触发上传;小文件(如几字节、500字节左右)可触发上传接口,大文件无法触发且无任何提示。升级到v4.8.22版本后,上传操作出现404异常。日志显示上传成功,但无文件读取相关报错,仅记录接口请求完成信息。

现象

用户反馈上传的文件未被系统读取。部分场景下,测试界面可正常上传文件,但对话界面无法触发上传;小文件(如几字节、500字节左右)可触发上传接口,大文件无法触发且无任何提示。升级到v4.8.22版本后,上传操作出现404异常。日志显示上传成功,但无文件读取相关报错,仅记录接口请求完成信息。

可能原因

存在两类已知触发因素:一是.env配置文件中的FE_DOMAIN项未与前端实际运行端口同步修改,导致接口请求异常;二是初始化配置中uploadFileMaxSize默认最大值为500字节,且无公开配置入口,超出该大小的文件无法正常触发上传。

排查步骤

  1. 查看系统日志,确认是否存在上传成功但无文件读取日志的情况,或升级版本后出现404异常。
  2. 打开项目根目录下的.env配置文件,定位FE_DOMAIN配置项。
  3. 核对FE_DOMAIN中的端口号是否与前端实际运行的端口一致。
  4. 检查文件大小是否超出uploadFileMaxSize的默认限制(500字节)。

解决与验证

修改.env文件中的FEDOMAIN配置,使其与前端实际运行端口匹配。例如若前端运行在http://localhost:3010,则将FEDOMAIN设为http://localhost:3010。若存在文件大小限制问题,可按实际需求调整uploadFileMaxSize配置(需确认对应配置入口)。验证时上传测试文件,确认上传接口触发成功,且AI可正常读取文件内容,同时检查日志是否出现文件处理相关的正常日志。

来源: FastGPT GitHub issue #3832