做一個簡單的新增資料功能,用 jQuery 的 post 把 JSON 傳到 JSP 後端。後端處理完了,前端卻怎麼都不進入回呼函式。
$.post("addGs.do", "x=" + JSON.stringify(x), function (d) {
alert('成功');
}, "json");
用 Firefox 的除錯工具看,回應正常、狀態 200 OK,看起來一切沒問題。
只好回頭翻 jQuery API 文件,其中提到:如果最後一個參數宣告為 json,就要求回傳的資料必須是合法的 JSON 格式。
於是疑問來了——會不會是後端吐出的 JSON 不標準?
想到現在通用的 JSON 規範要求 key 與 value 都要用雙引號包起來,馬上改程式:
try {
d.add(gs);
out.println("{\"s\":\"ok\"}");
} catch (Exception e) {
out.println("{\"s\":\"err\"}");
e.printStackTrace();
}
這次終於成功進入回呼了。
在 json 模式下,回傳內容必須是嚴格的 JSON 才能觸發 success 回呼;如果改用 text 模式,就沒有這個限制。
當你宣告 dataType: "json"(或 post 的第三個參數填 "json"),jQuery 會在資料回來後先跑一次 jQuery.parseJSON()。解析失敗時它會拋出例外,這條請求就被判定為失敗,直接走 error 分支,success 回呼自然不會被執行。
而畫面上完全看不到錯誤,是因為大多數人沒有寫 error 回呼。這正是這個問題最容易被誤判為「後端沒收到」或「請求沒發出」的原因。
永遠加上 error 回呼。至少 alert 一下,或把 textStatus 與 errorThrown 印到 console,能省下大量排查時間:
$.post("addGs.do", { x: JSON.stringify(x) }, function (d) {
alert('成功');
}, "json").fail(function (xhr, status, err) {
console.log(status, err, xhr.responseText); // 直接看到後端到底回了什麼
});
後端輸出 JSON 時別混入其他字元。JSP 頁面多餘的空白行、註解、或被 autoFlush 吐出的 HTML,都會讓整段回應變成非法 JSON。把 page contentType="application/json" 設定好,並確認畫面上沒有任何額外輸出。
用物件而不是字串傳參數。{ x: JSON.stringify(x) } 比 "x=" + JSON.stringify(x) 更安全,jQuery 會自動處理 URL 編碼,避免特殊字元把 query string 弄壞。