Java HttpClient上传图片报Bad Request: no files uploaded错误求助

你的代码核心问题是没有按照multipart/form-data的规范封装上传的文件。直接通过BodyPublishers.ofFile传输文件内容，服务端无法识别这是一个表单文件字段，因此返回"no files uploaded"错误。

修正后的代码示例 #

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Paths;
import java.net.http.MultipartBodyPublisher;
import java.net.http.HttpRequest.BodyPublisher;

public class ImageUploader {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        
        // 构建multipart请求体，指定文件字段名（需和服务端要求一致，示例用"file"）
        BodyPublisher multipartBody = MultipartBodyPublisher.create()
                .addPart("file", Paths.get("\\SpringProject\\ImageProcessing\\src\\image.jpg"))
                .build();

        HttpRequest postRequest = HttpRequest.newBuilder()
                .uri(new URI("url to upload file and fetch info"))
                .setHeader("Authorization", "Bearer " + tokenKey)
                // 无需手动设置Content-Type，MultipartBodyPublisher会自动添加带边界的正确头
                .POST(multipartBody)
                .build();

        HttpResponse<String> response = client.send(postRequest, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

关键修正点 #

• 用MultipartBodyPublisher构建请求体：Java 16及以上版本提供的这个工具类，会自动按照multipart/form-data规范封装文件，包括生成服务端可识别的边界标识，解决文件字段无法被识别的问题。
• 移除手动设置的Content-Type头：手动设置的multipart/form-data缺少必要的边界信息，服务端无法解析请求内容。MultipartBodyPublisher会自动生成带边界的完整Content-Type头（格式如multipart/form-data; boundary=XXX）。
• 匹配服务端字段名：代码中的"file"是表单字段名，必须和服务端接口要求的字段名完全一致（比如有些服务端要求用"image"），否则服务端依然无法识别上传的文件。
• 修正路径格式：原路径中的单反斜杠\要改为双反斜杠\\，或者使用正斜杠/，避免路径解析报错。

低版本Java兼容方案 #

如果你的Java版本低于16，MultipartBodyPublisher不可用，此时需要手动拼接符合multipart/form-data格式的请求体，或者引入Apache HttpClient等第三方库来简化文件上传逻辑。

内容的提问来源于stack exchange，提问作者Manoj