Ajax 往後台傳 JSON 格式的資料時,回報 415 錯誤:

function saveUser() {
var uuId = document.getElementById("uuid").value;
var idCard = document.getElementById("idCard").value;
alert(uuId + idCard);
// 被註解的寫法(正解,見下文)
// var result = new Object();
// result.uuId = uuId;
// result.idCard = idCard;
// var saveData = JSON.stringify(result);
// alert(saveData);
$.ajax({
url: "xdds/saveUser.do?random=" + Math.random(),
type: "post",
data: { "uuid": uuId, "idCard": idCard },
// data: saveData,
dataType: 'json',
// contentType: "application/json",
success: function (data) { }
});
}
@RequestMapping(value = "/saveUser.do", method = { RequestMethod.POST })
@ResponseBody
public Map<String, Object> saveUser(@RequestBody MapUser user) {
Map<String, Object> map = new HashMap<String, Object>();
System.out.println(user.getUuid() + user.getIdCard());
map.put("result", "fda");
return map;
}
415 的全名是 Unsupported Media Type——「請求的內容格式不被該端點接受」。很多人會直覺認為是 JSON 字串格式沒寫對(key 與 value 都要加雙引號),但那其實不是本例的主因。
關鍵在 Content-Type 標頭。當你寫 data: { "uuid": uuId, "idCard": idCard } 這種物件寫法時,jQuery 會自動把它轉成 uuid=xxx&idCard=yyy 的表單查詢字串,並把 Content-Type 設為 application/x-www-form-urlencoded。
但後端的 @RequestBody 要求的是「請求本文本身就是一份 JSON 文件」,對應的標頭必須是 application/json。兩邊對不上,Spring 找不到能處理該媒體類型的 converter,於是丟出 415。
把註解的兩行打開即可:
var result = {};
result.uuId = uuId;
result.idCard = idCard;
var saveData = JSON.stringify(result); // 轉成真正的 JSON 字串
$.ajax({
url: "xdds/saveUser.do?random=" + Math.random(),
type: "post",
data: saveData, // 送字串,不要送物件
contentType: "application/json; charset=utf-8", // 關鍵:宣告媒體型別
dataType: "json",
success: function (data) { }
});
兩個條件必須同時成立:data 要是 JSON 字串,且 contentType 要宣告為 application/json。少一個都不行——只改 contentType 而 data 還是物件,jQuery 仍會把它當表單處理並覆寫標頭。
如果你並不希望請求本文是 JSON,也可以把後端的 @RequestBody 拿掉,改用 @RequestParam 或直接用 MapUser user 接收表單參數:
@RequestMapping(value = "/saveUser.do", method = RequestMethod.POST)
@ResponseBody
public Map<String, Object> saveUser(MapUser user) { ... }
兩種做法都對,重點是前後端對「資料以什麼格式傳」這件事要有共識。這也是 415 這類錯誤的共通教訓:它幾乎總是代表溝通不一致,而不是程式邏輯寫錯。