Java使用Multipart POST上传视频至Video Indexer API失败求助

我太懂这种 frustration 了——Postman里跑的好好的请求，换成Java代码就掉链子，十有八九是请求构造的细节没和Postman对齐。结合你的场景，咱们一步步排查最容易踩的坑：

1. 逐行核对请求头，一个都不能少 #

Postman里的请求头（比如Authorization、Content-Type、x-ms-region这类自定义头）必须1:1复刻到Java代码里，尤其注意这几个关键点：

• Content-Type：如果是上传文件，Postman会自动生成multipart/form-data; boundary=xxx，Java里绝对不能硬写死边界值，得让HTTP客户端（比如OkHttp、Apache HttpClient）自动生成边界
• Authorization：确认格式是Bearer <你的令牌>，有没有多打/少打空格，或者token是否过期（Video Indexer的令牌有效期不长，要确保是实时获取的）
• 其他业务头：比如Video Indexer要求的x-ms-client-request-id、x-ms-user-id，要和Postman里的取值完全一致

2. 检查Multipart文件上传的构造逻辑 #

Java处理multipart/form-data很容易在细节上出错，比如：

• 确认文件参数的名称和Postman里完全一致（比如Postman里用file作为参数名，Java里不能写成videoFile）
• 确保文件流正确打开，没有提前关闭，或者本地文件路径写错（比如相对路径没找到文件）
• 给你个OkHttp的正确示例参考：

// 构造Multipart请求体
RequestBody requestBody = new MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        // 上传文件：参数名、文件名、文件流+媒体类型
        .addFormDataPart("file", "my-video.mp4",
                RequestBody.create(new File("/path/to/your/video.mp4"), MediaType.parse("video/mp4")))
        // 加上Video Indexer要求的其他表单参数，比如name、description
        .addFormDataPart("name", "MyTestVideo")
        .addFormDataPart("description", "Uploaded via Java")
        .build();

// 构造请求
Request request = new Request.Builder()
        .url("https://api.videoindexer.ai/{region}/Accounts/{accountId}/Videos?name=MyVideo&privacy=Private&language=en-US")
        .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN")
        .addHeader("x-ms-region", "eastus")
        .post(requestBody)
        .build();

3. 排查认证和权限问题 #

有时候Postman里的token是通过前置请求自动获取的，Java里要确保获取token的逻辑和Postman一致：

• 确认获取token时用的订阅密钥、资源路径正确
• 检查token的权限范围是否覆盖视频上传接口（比如有没有申请到Video.Index的权限）

4. 抓包对比请求原始内容，直接找差异 #

最有效的调试方法是把Java发送的请求和Postman的请求抓包对比：

• 用Fiddler或Charles抓Java的请求包，对比请求头、请求体的每一项
• 或者在Java代码里加拦截器打印完整请求（以OkHttp为例）：

OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(new Interceptor() {
            @Override
            public Response intercept(Chain chain) throws IOException {
                Request req = chain.request();
                // 打印请求头
                System.out.println("Request Headers: " + req.headers());
                // 打印请求体（multipart的话可以打印toString看结构）
                System.out.println("Request Body: " + req.body().toString());
                return chain.proceed(req);
            }
        })
        .build();

5. 结合报错信息精准定位 #

你提到有报错信息，把具体的错误细节（比如HTTP状态码401/400/500，或者响应体里的错误描述）贴出来能更快解决：

• 401 Unauthorized：大概率是token无效、格式错误，或者请求头里没加Authorization
• 400 Bad Request：可能是缺少必要的表单参数、文件格式不支持，或者multipart构造错误
• 413 Request Entity Too Large：检查Video Indexer的文件大小限制，或者Java客户端有没有设置上传大小限制

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