Android Fragment中使用Volley调用API报com.android.volley.ClientError如何解决

你遇到的com.android.volley.ClientError错误核心原因是请求参数格式与请求头声明不匹配，属于典型的客户端请求配置错误，以下是具体修复步骤：

错误根因说明 #

你当前代码存在两处明显的配置冲突：

• 你通过getParams()传递的是application/x-www-form-urlencoded格式的表单参数，但又在请求头中强制声明Content-Type: application/json，服务端收到请求后按照JSON格式解析请求体失败，就会返回4xx类的客户端错误。
• 重试策略配置错误，你将重试次数错误设置为30000，会导致异常重试逻辑混乱。

修复方案 #

根据你Postman的调用方式二选一即可：

方案1：Postman使用表单格式（x-www-form-urlencoded/form-data）传参 #

这是改动最小的适配方案，仅需要修改两处配置：

1. 删除请求头中错误的Content-Type配置，Volley的StringRequest使用getParams()时会自动携带正确的表单类型请求头
2. 修正重试策略为合理配置

修正后的核心代码片段如下：

@Override
public Map<String, String> getHeaders() throws AuthFailureError {
    Map<String, String> params = new HashMap<String, String>();
    params.put("Accept", "application/json");
    return params;
}

// 替换原有错误的重试策略
request.setRetryPolicy(new DefaultRetryPolicy(
    30000, // 超时时间30秒
    DefaultRetryPolicy.DEFAULT_MAX_RETRIES, // 默认重试次数1次
    DefaultRetryPolicy.DEFAULT_BACKOFF_MULT // 默认退避乘数
));

方案2：Postman使用JSON格式传参 #

如果接口要求请求体为JSON格式，就不要使用getParams()传参，直接改用JsonObjectRequest即可，示例代码如下：

private void volleyApiCall(final String theEmail, final String theToken) {
    RequestQueue queue = Volley.newRequestQueue(getActivity());
    // 组装JSON参数
    JSONObject params = new JSONObject();
    try {
        params.put("email", theEmail);
        params.put("token", theToken);
    } catch (JSONException e) {
        e.printStackTrace();
    }

    JsonObjectRequest request = new JsonObjectRequest(Request.Method.POST, URL, params, 
        new Response.Listener<JSONObject>() {
            @Override
            public void onResponse(JSONObject jsonObject) {
                // 原有响应处理逻辑，不需要再手动转JSONObject
                Log.d(TAG, "onResponse: >>  SUCCESS SUCCESS");
                Log.d(TAG, "onResponse: jsonObject >> " + jsonObject);
                try {
                    String status = (jsonObject.getString("status"));
                    Log.d(TAG, "onResponse: status >> " + status);
                    // 其余原有逻辑
                } catch (JSONException e) {
                    e.printStackTrace();
                }
            }
        }, new Response.ErrorListener() {
            @Override
            public void onErrorResponse(VolleyError error) {
                // 新增错误详情打印，方便排查问题
                if (error.networkResponse != null) {
                    Log.d("API_ERROR", "状态码：" + error.networkResponse.statusCode);
                    Log.d("API_ERROR", "返回内容：" + new String(error.networkResponse.data));
                }
                // 原有错误处理逻辑
                Toast.makeText(getActivity(), "Failed to get response = " + error, Toast.LENGTH_SHORT).show();
            }
        }) {
            @Override
            public Map<String, String> getHeaders() throws AuthFailureError {
                Map<String, String> headers = new HashMap<>();
                headers.put("Accept", "application/json");
                headers.put("Content-Type", "application/json");
                return headers;
            }
    };

    request.setRetryPolicy(new DefaultRetryPolicy(
        30000,
        DefaultRetryPolicy.DEFAULT_MAX_RETRIES,
        DefaultRetryPolicy.DEFAULT_BACKOFF_MULT
    ));
    queue.add(request);
}

通用排查技巧 #

如果修改后仍有报错，可以在错误回调中打印服务端返回的原始响应内容，能直接定位具体错误原因，不需要盲调。

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