Android Volley 框架：自定義 GsonRequest 導致 POST 參數丟失排查

問題現象

使用自定義 GsonRequest extends Request<T> 發送 POST 請求，服務端收不到參數（params 為空）。

核心原因分析

1. 重寫了 getBodyContentType() 返回 application/json，導致 Volley 走 JSON 請求體邏輯，而非表單編碼邏輯。
2. 未重寫 getBody() 方法：默認實現調用 getParams() 並編碼為 application/x-www-form-urlencoded。若 Content-Type 為 JSON，必須在 getBody() 中手動序列化參數為 JSON 字節數組。
3. Volley 版本差異：舊版本 Request 類邏輯與新版不同，部分版本不支持直接在 getParams() 返回 Map 實現 JSON POST。

解決方案

方案一：改用 JsonObjectRequest / JsonArrayRequest（官方推薦）

JsonObjectRequest request = new JsonObjectRequest(
    Request.Method.POST, url, jsonObject,
    response -> { /* 成功 */ },
    error -> { /* 失敗 */ }
);

自動處理 JSON 序列化、Content-Type 設置、響應解析。

方案二：修正自定義 Request（若必須自定義）

@Override
public byte[] getBody() throws AuthFailureError {
    try {
        // 將 mParams 序列化為 JSON 字節數組
        return mGson.toJson(mParams).getBytes(PROTOCOL_CHARSET);
    } catch (Exception e) {
        throw new AuthFailureError(e);
    }
}

// 保留 getBodyContentType() 返回 application/json
// 移除或註釋 getParams()，避免混淆

方案三：使用 StringRequest 發送表單（兼容舊版本）

StringRequest request = new StringRequest(Request.Method.POST, url,
    response -> { /* 成功 */ },
    error -> { /* 失敗 */ }
) {
    @Override
    protected Map<String, String> getParams() {
        return params; // 你的參數 Map
    }
};

此方式自動編碼為 application/x-www-form-urlencoded，大多數後端框架（Spring MVC、PHP、Node.js）原生支持。

調試技巧

• 啟用 Volley 日誌：VolleyLog.DEBUG = true;
• 抓包工具（Charles/Fiddler/Wireshark）對比請求體與 Content-Type。
• 檢查服務端日誌：確認是讀取 Request Body 還是 Form Data。

最佳實踐建議

1. 優先使用官方提供的 Request 子類（JsonObjectRequest, StringRequest），減少造輪子 Bug。
2. 統一網絡層封裝：封裝 BaseRequest、ResponseListener、錯誤碼處理，業務層調用簡潔。
3. 考慮遷移到 OkHttp + Retrofit：現代 Android 網絡開發主流選擇，類型安全、攔截器豐富、協程支持完美。

Volley 適合簡單項目，複雜場景下自定義 Request 极易踩坑，拥抱現代網絡庫更明智。