Retrofit中含?的URL为何会将POST请求转换为GET请求？

嘿，这个问题我之前帮好几个开发者排查过，咱们先搞清楚为啥会出现这种情况，再一步步解决它：

为什么会出现POST变GET的情况？ #

其实Retrofit本身不会自动把带?的POST请求转成GET，大概率是以下几种原因导致的：

• 后端路由/重定向问题：很多后端框架的路由规则可能会把带特定查询参数的POST请求重定向为GET，或者路由解析时错误识别了请求方法，导致你看到的结果像是GET请求的响应。
• 错误的Retrofit写法：如果你把查询参数直接硬编码在@POST的URL里（比如@POST("index.php?route=api/account/login")），虽然Retrofit会保留POST方法，但有些服务器会对这种URL格式的POST请求做特殊处理，或者你可能不小心混用了注解（比如同时用了@GET和@POST相关的配置）。
• OkHttp拦截器篡改：如果你的项目里加了自定义的OkHttp拦截器，有可能拦截器里的代码修改了请求方法，把POST改成了GET。
• 空请求体的问题：如果你的POST请求没有携带任何请求体（既没有@Body、@FormUrlEncoded+@Field，也没有@Multipart），有些服务器会默认把这种“无体POST”当作GET请求处理。

解决办法 #

针对上面的原因，咱们逐个解决：

1. 规范使用Retrofit的参数注解（最推荐） #

不要把查询参数硬编码在@POST的URL里，而是用@Query或@QueryMap来传递，这样既符合Retrofit的设计规范，也能避免URL解析带来的问题：

// 错误写法：把查询参数硬编码在URL中
@POST("index.php?route=api/account/login")
Call<LoginResponse> login(@Body LoginRequest request);

// 正确写法：用@Query分离路径和查询参数
@POST("index.php")
Call<LoginResponse> login(
    @Query("route") String route,
    @Body LoginRequest request
);

// Kotlin可以直接给参数加默认值，调用更方便
@POST("index.php")
fun login(
    @Query("route") route: String = "api/account/login",
    @Body request: LoginRequest
): Call<LoginResponse>

这样Retrofit会正确构建POST请求，同时把route作为查询参数附加到URL上，请求方法始终保持POST。

2. 排查后端配置 #

如果确认Retrofit发送的是POST请求（可以用OkHttp的日志拦截器打印请求详情），但服务器返回的是GET的结果，那就要去查后端的路由规则：

• 检查是否有重定向逻辑把POST请求转成了GET；
• 确认后端的接口是否正确支持POST方法，有没有把带特定query参数的请求误解析为GET。

3. 检查OkHttp拦截器 #

打开项目里的OkHttp客户端配置，查看所有自定义拦截器，确认没有代码修改了请求方法：

// 示例：检查拦截器里是否有修改method的代码
Interceptor myInterceptor = chain -> {
    Request originalRequest = chain.request();
    // 这里如果有把POST改成GET的代码，就会导致问题，需要删除
    Request newRequest = originalRequest.newBuilder()
        // .method("GET", originalRequest.body()) 
        .build();
    return chain.proceed(newRequest);
};

4. 给POST请求添加合法的请求体 #

如果你的业务逻辑确实需要无请求体的POST，那可以显式添加一个空的请求体，避免服务器把它当成GET：
比如用@FormUrlEncoded加一个占位字段：

@FormUrlEncoded
@POST("index.php")
Call<LoginResponse> login(
    @Query("route") String route,
    @Field(encoded = true) String dummy // 占位字段，值传空字符串即可
);

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