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

解决FastGPT本地文件上传接口调用后训练报datasetId缺失问题

私有部署v4.14.3版本中,调用/api/core/dataset/collection/create/localFile接口上传本地文件至知识库,可提交成功但训练异常,报错信息为datasetId is required for S3 files。该问题在11月20日前未出现,12月1日首次触发。

现象

私有部署v4.14.3版本中,调用/api/core/dataset/collection/create/localFile接口上传本地文件至知识库,可提交成功但训练异常,报错信息为datasetId is required for S3 files。该问题在11月20日前未出现,12月1日首次触发。手动导入本地文件至知识库可正常提交并完成训练。

可能原因

该问题的具体根因未在当前issue中明确,结合报错信息与场景对比,推测接口在处理本地文件上传请求时,未正确匹配本地文件的参数校验逻辑,误触发了S3文件上传的datasetId校验规则。需通过服务端接口日志进一步确认根因。

排查步骤

  1. 确认当前使用的FastGPT版本为私有部署v4.14.3。
  2. 检查调用接口时的请求参数,确认data字段的JSON结构中包含datasetIdparentId等必填参数。
  3. 核对完整报错信息是否为datasetId is required for S3 files,排除其他参数错误导致的异常。
  4. 查看服务端接口日志,确认接口是否正确解析了请求中的data参数与文件内容。
  5. 对比手动导入与接口调用的请求差异,确认接口请求的格式是否符合要求。

解决与验证

  1. 修正本地文件上传请求的Content-Type类型,使其与实际上传的文件类型匹配。
  2. 确保multipart/form-data请求中data字段的JSON格式正确,包含所有必填参数。
  3. 重新调用/api/core/dataset/collection/create/localFile接口上传文件,验证训练流程是否正常完成。
  4. 若问题仍未解决,需结合服务端日志进一步排查参数解析逻辑。

来源:FastGPT GitHub issue