萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Firefox 下 jQuery AJAX 處理 Struts2 返回 JSON 類型報 [object XMLDocument] 解決方案

問題現象

在 Firefox 中使用 jQuery `$.ajax` 請求 Struts2 Action 返回 JSON 時,`success` 回調收到的 `data` 為 `[object XMLDocument]` 而非解析後的 JSON 對象,導致無法正常訪問數據屬性。

根本原因

  • Struts2 默認返回 `Content-Type: text/html` 或 `application/xml`。
  • jQuery 根據 `Content-Type` 自動判斷數據類型:`text/html` → 文本,`application/xml` → XMLDocument,`application/json` → 自動解析 JSON。
  • Firefox 嚴格遵循 MIME 類型,將非 `application/json` 響應體解析為 XMLDocument(即使內容是合法 JSON)。

解決方案:服務端設置正確 Content-Type

// Struts2 Action 中,在輸出前設置
ServletActionContext.getResponse().setContentType("application/json;charset=UTF-8");
// 或
response.setContentType("application/json;charset=UTF-8"); // 若在 Servlet/JSP 中

// 然後輸出 JSON 字符串
PrintWriter out = response.getWriter();
out.print(jsonString);
out.flush();
out.close();

完整 Action 示例

public class JsonAction extends ActionSupport {
    private String jsonResult;
    
    public String execute() {
        // 業務邏輯生成 JSON
        jsonResult = "{\"success\":true,\"msg\":\"操作成功\",\"data\":{\"id\":1,\"name\":\"張三\"}}";
        return SUCCESS;
    }
    
    public String getJsonResult() { return jsonResult; }
    
    // Struts2 配置:
    //   application/json
    //   jsonResult
    // 
}

前端 jQuery 代碼(配合正確 Content-Type)

$.ajax({
    url: '/jsonAction.action',
    type: 'POST',
    dataType: 'json', // 明確指定預期 JSON,jQuery 會根據 Content-Type 自動解析
    success: function(data) {
        // data 現為 JS 對象
        console.log(data.success); // true
        console.log(data.data.name); // "張三"
    },
    error: function(xhr, status, error) {
        console.error("AJAX 錯誤:", status, error);
        // 若仍報錯,檢查 xhr.responseText 看原始響應
    }
});

替代方案:前端強制解析(不推薦,治標不治本)

$.ajax({
    // 不指定 dataType,或指定 text
    dataType: 'text',
    success: function(text) {
        try {
            var data = JSON.parse(text); // 手動解析
            // 後續邏輯
        } catch (e) {
            console.error("JSON 解析失敗:", text);
        }
    }
});

避坑檢查清單

  1. 響應頭 `Content-Type` **必須**為 `application/json;charset=UTF-8`(或 `application/json`)。
  2. 響應體**必須**是合法 JSON(無 BOM、無額外輸出、無 HTML 註釋)。
  3. Struts2 使用 `` 時確保 `contentType` 參數正確。
  4. 攔截器/過濾器未修改響應頭/體。
  5. jQuery 版本 ≥ 1.9(舊版對 XML/HTML 誤判更多)。

現代最佳實踐

  • 後端統一返回 `application/json`,配合 `@RestController` (Spring) / `JsonResult` (ASP.NET Core) / `ctx.body = obj` (Koa) 等框架原生支持。
  • 前端使用 `fetch` + `response.json()` 或 `axios` 自動處理。
  • API 規範化:統一錯誤碼結構、版本控制、OpenAPI 文檔。
copyright © 萬盛學電腦網 all rights reserved