Retrofit 2模拟Postman表单请求响应与预期不符问题求助

嘿，我帮你捋捋Postman能跑通但Retrofit不行的常见坑——大概率是请求格式、注解或者请求头的细节没对齐，咱们一步步来：

先搞清楚核心：你到底要发哪种请求？ #

你提到Postman用的是「form-data」，但请求头写的是Content-Type: application/x-www-form-urlencoded; charset=UTF-8——这俩其实是完全不同的请求体格式：

• 「x-www-form-urlencoded」是键值对编码成类似key1=value1&key2=value2的格式，对应请求头application/x-www-form-urlencoded
• 「form-data」是多部分表单，对应请求头multipart/form-data（会自动带boundary分隔符）

Postman里如果选了「form-data」但手动改了Content-Type为x-www-form-urlencoded，其实是矛盾的，先确认你实际要发的是哪种格式，再对应Retrofit配置。

情况1：实际是x-www-form-urlencoded请求（对应你写的请求头） #

这时候Retrofit要这么配置：

1. 接口定义用对注解 #

必须用@FormUrlEncoded+@Field，不能用@Multipart或者@Body：

public interface YourApiService {
    @FormUrlEncoded
    @POST("你的接口路径")
    Call<YourResponseModel> submitData(
        // 可以在这里设置User-Agent，或者全局统一设置
        @Header("User-Agent") String userAgent,
        @Field("param1") String value1,
        @Field("param2") int value2
        // 其他参数依次加@Field
    );
}

2. 避免全局请求头冲突 #

如果你的Retrofit实例全局设置了Content-Type（比如默认的application/json），会覆盖局部配置，检查OkHttpClient的配置：

// 不要全局设置Content-Type为非x-www-form-urlencoded的类型
OkHttpClient okHttpClient = new OkHttpClient.Builder()
    // 如果要全局统一User-Agent，加个拦截器更方便
    .addInterceptor(chain -> {
        Request modifiedRequest = chain.request().newBuilder()
            .header("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.186 Safari/537.36")
            .build();
        return chain.proceed(modifiedRequest);
    })
    .build();

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("你的BaseUrl")
    .client(okHttpClient)
    .addConverterFactory(GsonConverterFactory.create())
    .build();

3. 调试对比请求细节 #

用OkHttp的日志拦截器看实际发送的请求，和Postman的请求做对比：
先加依赖（如果没加）：

implementation 'com.squareup.okhttp3:logging-interceptor:3.9.1' // 对应Retrofit 2.3.0的OkHttp版本

然后配置日志拦截器：

HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor();
loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY); // 打印完整请求响应

OkHttpClient okHttpClient = new OkHttpClient.Builder()
    .addInterceptor(loggingInterceptor)
    .addInterceptor(userAgentInterceptor) // 前面的User-Agent拦截器
    .build();

看日志里的请求头、请求体，和Postman「Code」标签里的curl命令对比，哪里不一样就改哪里。

情况2：实际是form-data（multipart）请求 #

如果你确实要发multipart/form-data（Postman里选的是form-data，没改Content-Type），那请求头不需要手动设置application/x-www-form-urlencoded，Retrofit会自动生成正确的Content-Type：

1. 接口定义用@Multipart+@Part #

public interface YourApiService {
    @Multipart
    @POST("你的接口路径")
    Call<YourResponseModel> submitFormData(
        @Header("User-Agent") String userAgent,
        @Part("param1") RequestBody value1,
        @Part("param2") RequestBody value2
        // 如果是文件，用@Part MultipartBody.Part
    );
}

调用时构建RequestBody：

RequestBody value1 = RequestBody.create(MediaType.parse("text/plain"), "参数值1");
RequestBody value2 = RequestBody.create(MediaType.parse("text/plain"), "参数值2");

yourApiService.submitFormData("你的User-Agent", value1, value2)
    .enqueue(new Callback<YourResponseModel>() {
        // 回调处理
    });

最后总结 #

先把Postman的请求格式搞准（是x-www-form-urlencoded还是multipart/form-data），然后对应Retrofit的注解配置，再通过日志对比请求细节，基本就能定位问题啦～

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