Upload documents issue

[keepOnesResolve]

Self Checks

• I have searched for existing issues search for existing issues, including closed ones.
• I confirm that I am using English to submit this report (Language Policy).
• Non-english title submitions will be closed directly ( 非英文标题的提交将会被直接关闭 ) (Language Policy).
• Please do not modify this template :) and fill in all the required fields.

Describe your problem

https://ragflow.io/docs/dev/http_api_reference#upload-documents documentUrl
Upload documents use HTTP call ,Return to the source {"code":101,"message":"No file part!"} How to solve it? There is a discussion group.?

[dosubot]

The error {"code":101,"message":"No file part!"} means the API did not receive a file in the expected multipart/form-data field named file. To fix this, make sure your HTTP POST request to /api/v1/datasets/{dataset_id}/documents uses multipart/form-data and includes the file under the parameter name file (not files, document, etc.) with a valid filename and content.

If you're using a library like Python requests or Java's HTTP client, do not manually set the Content-Type: multipart/form-data header—let the library handle it so the multipart boundary is set correctly. Manually setting this header often causes the "No file part!" error because the backend can't parse the file part without the boundary [source].

Also, check that your file name is not empty and is less than 128 bytes, and that you are within the file size and count limits (e.g., 10MB per file and 128 files per account on demo.ragflow.io) [source].

There is no official discussion group for RAGFlow document upload issues, but most troubleshooting and community support happens in GitHub issues and discussions [source].

For reference, here’s a working Python example:

import requests

url = "http://your-ragflow-host/api/v1/datasets/{dataset_id}/documents"
headers = {"Authorization": "Bearer <your-api-key>"}
files = {'file': ('filename.pdf', open('filename.pdf', 'rb'))}

response = requests.post(url, headers=headers, files=files)
print(response.text)

If you follow this pattern and still get the error, double-check the parameter name and try removing any explicit Content-Type header from your request.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[keepOnesResolve]

别机器人回复我了，有java用Hutool发送请求的案例给我提供参考吗？ Don't reply to me from the robot. Is there any case where Java uses Hutool to send requests that you can provide as a reference for me? 棒 ***@***.***  

…

------------------&nbsp;原始邮件&nbsp;------------------ 发件人: "infiniflow/ragflow" ***@***.***&gt;; 发送时间:&nbsp;2025年10月29日(星期三) 下午3:36 ***@***.***&gt;; ***@***.******@***.***&gt;; 主题:&nbsp;Re: [infiniflow/ragflow] Upload documents issue (Issue #10871) dosubot[bot] left a comment (infiniflow/ragflow#10871) The error {"code":101,"message":"No file part!"} means the API did not receive a file in the expected multipart/form-data field named file. To fix this, make sure your HTTP POST request to /api/v1/datasets/{dataset_id}/documents uses multipart/form-data and includes the file under the parameter name file (not files, document, etc.) with a valid filename and content. If you're using a library like Python requests or Java's HTTP client, do not manually set the Content-Type: multipart/form-data header—let the library handle it so the multipart boundary is set correctly. Manually setting this header often causes the "No file part!" error because the backend can't parse the file part without the boundary [source]. Also, check that your file name is not empty and is less than 128 bytes, and that you are within the file size and count limits (e.g., 10MB per file and 128 files per account on demo.ragflow.io) [source]. There is no official discussion group for RAGFlow document upload issues, but most troubleshooting and community support happens in GitHub issues and discussions [source]. For reference, here’s a working Python example: import requests url = "http://your-ragflow-host/api/v1/datasets/{dataset_id}/documents" headers = {"Authorization": "Bearer <your-api-key&gt;"} files = {'file': ('filename.pdf', open('filename.pdf', 'rb'))} response = requests.post(url, headers=headers, files=files) print(response.text) If you follow this pattern and still get the error, double-check the parameter name and try removing any explicit Content-Type header from your request. To reply, just mention @dosu. How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other&nbsp;&nbsp;&nbsp;&nbsp; — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: ***@***.***&gt;

[dosubot]

下面是用 Java Hutool 实现 RAGFlow 文档上传（multipart/form-data）的参考代码，已符合 API 要求（参数名必须是 file，带 Authorization 头，不要手动设置 Content-Type）：

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.http.ContentType;
import cn.hutool.core.io.FileUtil;

import java.io.File;

public class RagflowUploadDemo {
    public static void main(String[] args) {
        String datasetId = "your-dataset-id";
        String apiKey = "your-api-key";
        File file = new File("your-file-path.pdf");

        HttpResponse response = HttpRequest.post("http://your-ragflow-host/api/v1/datasets/" + datasetId + "/documents")
            .header("Authorization", "Bearer " + apiKey)
            // 不要手动设置 Content-Type，Hutool 会自动处理 boundary
            .form("file", file, FileUtil.extName(file), ContentType.OCTET_STREAM)
            .timeout(60000)
            .execute();

        System.out.println(response.body());
    }
}

注意事项：

• 参数名必须是 file，不能用 files、document 等，否则会报 {"code":101,"message":"No file part!"}。
• 不要手动设置 Content-Type，Hutool 会自动带上 multipart boundary。
• 文件名不能超过 128 字节，且不能留空。
• 需要带上 Authorization: Bearer <your-api-key> 头。

如遇到 101 错误，重点检查参数名和 Content-Type 是否由 Hutool 自动处理。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}