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
相关产品推荐
相关产品推荐

