使用Volley发送含Base64的JSON体POST请求遇阻求助

我之前也踩过Volley处理带Base64的JSON请求体的坑，试了好几种变通方案都没用，最后靠自定义Request类解决了问题，给你分享这个亲测有效的方案：

1. 自定义Volley Request类 #

Volley默认的JsonObjectRequest有时候在处理复杂请求体（比如包含Base64）时会有兼容性问题，我们可以自己实现一个Request类，完全掌控请求体的构建：

import com.android.volley.Request;
import com.android.volley.Response;
import com.android.volley.toolbox.HttpHeaderParser;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.UnsupportedEncodingException;

public class CustomJsonRequest extends Request<JSONObject> {
    private final Response.Listener<JSONObject> mListener;
    private JSONObject mRequestBody;

    public CustomJsonRequest(int method, String url, JSONObject requestBody,
                             Response.Listener<JSONObject> listener, Response.ErrorListener errorListener) {
        super(method, url, errorListener);
        this.mListener = listener;
        this.mRequestBody = requestBody;
    }

    @Override
    public String getBodyContentType() {
        // 必须设置正确的Content-Type，确保服务器能识别JSON格式
        return "application/json; charset=utf-8";
    }

    @Override
    public byte[] getBody() {
        try {
            // 将JSON对象转为字节数组作为请求体
            return mRequestBody == null ? null : mRequestBody.toString().getBytes("utf-8");
        } catch (UnsupportedEncodingException uee) {
            return null;
        }
    }

    @Override
    protected Response<JSONObject> parseNetworkResponse(com.android.volley.NetworkResponse response) {
        try {
            String jsonString = new String(response.data, HttpHeaderParser.parseCharset(response.headers));
            return Response.success(new JSONObject(jsonString), HttpHeaderParser.parseCacheHeaders(response));
        } catch (UnsupportedEncodingException | JSONException e) {
            return Response.error(new com.android.volley.ParseError(e));
        }
    }

    @Override
    protected void deliverResponse(JSONObject response) {
        mListener.onResponse(response);
    }
}

2. 构建包含Base64的请求体并发送请求 #

接下来我们要正确生成Base64内容（注意用Base64.NO_WRAP避免生成换行符，防止服务器解析失败），然后构建JSON请求体，用自定义的Request发送：

// 1. 生成Base64字符串（示例：将文件转为Base64）
byte[] fileBytes = ...; // 替换为你的文件字节数组或其他需要编码的内容
String base64Content = android.util.Base64.encodeToString(fileBytes, android.util.Base64.NO_WRAP);

// 2. 构建JSON请求体
JSONObject jsonBody = new JSONObject();
try {
    jsonBody.put("base64Content", base64Content);
    // 如果有其他字段，在这里添加
    // jsonBody.put("otherField", "value");
} catch (JSONException e) {
    e.printStackTrace();
}

// 3. 初始化RequestQueue
RequestQueue queue = Volley.newRequestQueue(context);

// 4. 创建自定义请求并发送
CustomJsonRequest jsonRequest = new CustomJsonRequest(
        Request.Method.POST,
        "你的请求URL",
        jsonBody,
        response -> {
            // 请求成功的处理逻辑
            Log.d("Volley", "请求成功: " + response.toString());
        },
        error -> {
            // 请求失败的处理逻辑
            Log.e("Volley", "请求失败: " + error.getMessage());
        }
);

// 添加请求到队列
queue.add(jsonRequest);

常见坑排查 #

• 确保Base64编码时使用Base64.NO_WRAP参数，避免生成多余的换行符，导致服务器无法正确解析
• 检查服务器端是否配置了正确的Content-Type接收规则，确保能处理application/json类型的请求
• 确认请求URL正确，没有拼写错误，并且服务器能正常访问
• 如果还是失败，可以用抓包工具先模拟请求，确认服务器能接收包含Base64的JSON请求，再排查Volley代码的问题

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