本文详解 retrofit 在 android 中发起 http get 请求时，如何正确通过 url 查询参数（query parameters）传递数据，避免因类型不匹配、参数名错误或空值导致的 null 响应问题。

本文详解 retrofit 在 android 中发起 http get 请求时，如何正确通过 url 查询参数（query parameters）传递数据，避免因类型不匹配、参数名错误或空值导致的 null 响应问题。

在使用 Retrofit 发起 GET 请求时，必须严格区分请求方式与参数承载位置：GET 请求的参数只能通过 URL 查询字符串（query string）传递，不能放在请求体（body）中——这与 POST/PUT 请求有本质区别。你提供的 Postman 截图显示参数以 JSON 形式置于 Body，但这实际是 Postman 的误用行为：标准 HTTP GET 不支持 body，Postman 此时可能隐式转为 POST，或服务端做了非标准兼容。而 Retrofit 严格遵循 HTTP 规范，@GET 注解下所有参数必须通过 @Query 显式声明并拼接到 URL 末尾。

首先，修正接口定义中的关键错误：

✅ 正确写法（参数名需与 API 文档完全一致）：

public interface ShipRocketServiceAbilityInterface {
    @GET("courier/serviceability/")
    Call<shiprocketserviceabilityresponse> getService(
        @Query("pickup_postcode") String pickupPostcode,     // 注意：原问题中 Postman 用的是 "pickup_postcode"，但代码写成 "pickup_postcode" → 拼写必须一致！
        @Query("delivery_postcode") String deliveryPostcode,
        @Query("cod") String cod,
        @Query("weight") String weight
    );
}</shiprocketserviceabilityresponse>

⚠️ 原代码存在多个编译期/运行期隐患：

• 类型不匹配：boolean cod = "1" 和 float weight = "1" 是非法赋值（字符串不能直接赋给基本类型），会导致编译失败；
• 参数名不一致：Postman 中字段为 "pickup_postcode"（下划线），但接口中误写为 "pickup_postcode"（少一个 'o'？需核对文档）；
• 空值风险：若 response.body() 为 null，说明解析失败，常见于 JSON 结构与 ShipRocketServiceabilityResponse 模型类字段名/类型不匹配（如 currency 字段不存在或命名不一致）。

✅ 正确调用示例：

// 确保参数类型为 String（@Query 要求）
String pickupPostcode = "600114";
String deliveryPostcode = "600125";
String cod = "1";           // 不是 boolean，也不是 int
String weight = "1";       // 不是 float

Call<shiprocketserviceabilityresponse> call = shipRocket.getService(
    pickupPostcode, 
    deliveryPostcode, 
    cod, 
    weight
);

call.enqueue(new Callback<shiprocketserviceabilityresponse>() {
    @Override
    public void onResponse(Call<shiprocketserviceabilityresponse> call, Response<shiprocketserviceabilityresponse> response) {
        if (response.isSuccessful() && response.body() != null) {
            // ✅ 安全访问
            String currency = response.body().getCurrency();
            Log.d("API", "Currency: " + currency);
        } else {
            Log.e("API", "Response error: " + response.code() + " " + response.message());
        }
    }

    @Override
    public void onFailure(Call<shiprocketserviceabilityresponse> call, Throwable t) {
        Log.e("API", "Network or parsing error", t);
    }
});</shiprocketserviceabilityresponse></shiprocketserviceabilityresponse></shiprocketserviceabilityresponse></shiprocketserviceabilityresponse></shiprocketserviceabilityresponse>

? 关键注意事项：

• 始终校验 response.isSuccessful() 和 response.body() != null —— 网络错误、4xx/5xx 响应、JSON 解析失败均可能导致 body 为 null；
• 模型类必须精确映射响应 JSON：例如若返回 JSON 含 "currency": "INR"，则 ShipRocketServiceabilityResponse 中需有 private String currency; 及对应 getter；
• 调试技巧：启用 OkHttp 日志拦截器，查看实际发出的 URL（如 .../serviceability/?pickup_postcode=600114&delivery_postcode=600125...），确认参数是否拼接正确；
• 进阶建议：对多参数 GET 请求，可封装为 @QueryMap Map 提升可维护性：

  @GET("courier/serviceability/")
  Call<shiprocketserviceabilityresponse> getService(@QueryMap Map<string string> options);
  // 调用：
  Map<string string> params = new HashMap();
  params.put("pickup_postcode", "600114");
  params.put("delivery_postcode", "600125");
  params.put("cod", "1");
  params.put("weight", "1");</string></string></shiprocketserviceabilityresponse>

遵循以上规范，即可彻底解决 Retrofit GET 请求返回 null 的问题，确保参数准确送达服务端并正确解析响应。