You need to enable JavaScript to run this app. Retrofit2 POST请求PHP API时$_POST为空、返回api_token为null的问题
优惠活动
大模型
产品
解决方案
定价
更多

Retrofit2 POST请求PHP API时$_POST为空、返回api_token为null的问题

问题核心原因

当前Retrofit请求手动指定了Content-Type: application/json,使用@Body注解发送JSON格式的请求体。而PHP的超全局变量$_POST仅能解析Content-Type为application/x-www-form-urlencoded的标准表单编码数据,不会主动解析raw格式的JSON报文并存入$_POST数组——这就是服务端能收到请求、但读不到任何参数的根本原因。
之前Postman、iOS端测试正常,本质是这些客户端默认发送的是表单编码格式的请求,并非JSON格式,所以能被PHP正常解析。

无需修改服务端的安卓端调整方案
  • 修改Retrofit接口定义,替换原有的JSON Body传参逻辑,改用标准表单编码的参数提交方式,代码如下:
public interface ClientTester {
    // 必须加@FormUrlEncoded注解声明表单提交类型
    @FormUrlEncoded
    @POST("/****/****.php")
    Call<ResponseTester> postParams(
            // 用@Field注解直接声明表单字段,不需要手动构造Map
            @Field("api_token") String apiToken
    );
}

这个调整后Retrofit会自动把请求Content-Type设置为PHP可识别的application/x-www-form-urlencoded,参数会被自动编码为标准表单格式提交。

  • 调整请求发送逻辑,去掉原有构造Map参数的代码,直接透传参数值即可,示例代码:
private void sendRequest() {
    Retrofit.Builder builder = new Retrofit.Builder()
            .baseUrl("https://****.com")
            .addConverterFactory(GsonConverterFactory.create());

    Retrofit retrofit = builder.build();
    ClientTester service = retrofit.create(ClientTester.class);
    Call<ResponseTester> call = service.postParams("SomeToken");

    call.enqueue(new Callback<ResponseTester>() {
        @Override
        public void onResponse(Call<ResponseTester> call, Response<ResponseTester> response) {
            // 增加空判断避免响应异常导致空指针
            if (response.body() != null) {
                Log.d("VolleyResponse", "onResponse: " + response.body().getApiToken());
                tvResponse.setText(response.body().getApiToken()+"...");
            }
        }

        @Override
        public void onFailure(Call<ResponseTester> call, Throwable t) {
            Log.d("VolleyResponse", "onFailure: " + t.toString());
            tvResponse.setText(t.toString());
        }
    });
}
常见踩坑提醒
  • 不要手动添加@Headers({"Content-Type: application/json;charset=UTF-8"})请求头,这个头会导致PHP无法识别请求格式,哪怕用了@FormUrlEncoded也会读不到参数。
  • 不要继续使用@Body传Map/JSON字符串的方式,当前服务端没有实现json_decode(file_get_contents('php://input'))的解析逻辑,永远读不到这类JSON格式的提交内容。
  • 如果后续需要传多字段参数,只需要在接口方法里继续添加@Field("字段名") String 参数值即可,不需要改动其他逻辑。

内容的提问来源于stack exchange,提问作者Joseph Ali

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 08:54:05