DIV CSS 佈局教程網

修正 Spring MVC 回傳 JSON 導致 AJAX parseerror 的問題
編輯:AJAX基礎知識     

最近用 AJAX 接收 Spring MVC 傳來的 JSON 資料時,一直出現 parseerror。以下是錯誤情境與解法。

問題重現

前端:

$.ajax({
    type: 'POST',
    url: "groupFunctionEdit",
    dataType: 'json',
    contentType: "application/json",
    data: JSON.stringify(functiondata),
    success: function (data) {
        alert('資料載入成功' + data.msg);
    },
    error: function (xhr, type) {
        alert('資料載入失敗');
        console.log(type);
    }
});

後端 Controller:

@RequestMapping("/groupFunctionEdit")
public @ResponseBody Object groupFunctionEdit(
        @RequestBody List<YyGroupFunction> yyGroupFunctionList)
        throws JsonProcessingException {
    return "success";
}

查了資料後找到線索:當使用 String 這類簡單型別接收資料時,不需要 @RequestBody 註解;另外,Spring MVC 要處理 JSON,需要 jackson-databind 這個相依套件。

背後的原理是這樣的:方法宣告的回傳型別是 Object,加上 @ResponseBody 之後,Spring 會挑選合適的 HttpMessageConverter。當實際回傳的是字串時,StringHttpMessageConverter 往往會被優先選中,於是瀏覽器收到的是一段沒有引號包住的 success,而前端宣告 dataType: 'json',解析自然失敗,丟出 parseerror。

解法:後端明確序列化為 JSON 字串

前端不必修改,後端把要回傳的資料先包成 Map,再用 ObjectMapper 轉成 JSON 字串:

@RequestMapping("/groupFunctionEdit")
public @ResponseBody Object groupFunctionEdit(
        @RequestBody List<YyGroupFunction> yyGroupFunctionList)
        throws JsonProcessingException {

    Map<String, Object> map = new HashMap<String, Object>();
    map.put("msg", "success");

    ObjectMapper mapper = new ObjectMapper();
    String msg = mapper.writeValueAsString(map);

    return msg;
}

這樣送到前端的內容就变成了:

{"msg":"success"}

jQuery 便能正常解析,不再報錯。

另一種更常見的做法是讓回傳型別對上 Spring 的序列化能力,例如直接回傳 Map 或自訂物件並搭配 @ResponseBody,同時確認專案裡有 Jackson 相依、且 <mvc:annotation-driven /> 已啟用。這樣 MappingJackson2HttpMessageConverter 會自動處理,不必手動 writeValueAsString。兩種方式都能解決問題,差別只在序列化是由程式碼明確執行,還是交給框架處理。

另外,把回應的 Content-Type 明確設為 application/json;charset=UTF-8(例如 produces = "application/json;charset=UTF-8"),也能避免中文亂碼與型別判斷上的疑慮。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved