解决FastGPT调用本地文件创建数据集集合API的报错问题

现象

调用FastGPT的/api/core/dataset/collection/create/localFile接口时返回报错。使用的curl请求参数包括：请求地址为http://172.22.1.39:18080/api/core/dataset/collection/create/localFile，Authorization请求头为Bearer [REDACTED_CREDENTIAL]，上传文件路径为//root//1.txt，请求体data字段的JSON字符串包含datasetId为668def558bb4dab686438e54、parentId为null、trainingType为chunk等内容。请求附带两张报错截图。

可能原因

仅基于现有公开信息，可能的触发因素包括：请求中使用的认证令牌无效或权限不足；datasetId参数存在额外包裹符号或格式异常；上传文件路径格式不符合系统要求；multipart/form-data参数传递格式存在错误。

排查步骤

1. 核对并移除datasetId参数中的额外包裹符号，使用实际存在的有效数据集ID。
2. 检查上传文件的路径格式，修正为标准本地文件路径，避免双斜杠开头的异常路径。
3. 验证认证令牌的有效性与权限范围，确认令牌可正常调用目标接口。
4. 检查multipart/form-data请求中data字段的JSON字符串格式，确保无转义错误或格式损坏。

解决与验证

根据排查结果修正对应问题后，重新发起与示例一致的curl请求。若请求成功返回数据集集合创建的预期结果，则问题解决。

来源： FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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