DIV CSS 佈局教程網

jQuery ajax 出錯怎麼查:error 回呼參數與常見案例解析
編輯:JQuery入門技巧     

jQuery 把 ajax 封裝得很完整,日常開發幾乎不用直接面對 XMLHttpRequest。但也正因為封裝得太好,出錯時反而容易不知從何查起。以下把 error 回呼的參數結構與幾個常見案例整理清楚。

error 回呼的三個參數

$.ajax({
    url: "xxx.php",
    type: "post",
    dataType: "json",
    data: { "cat": "tom", "mouse": "jack" },
    success: function (data) {
        console.log(data);
    },
    error: function (jqXHR, textStatus, errorThrown) {
        console.log(jqXHR);
        console.log(textStatus);
        console.log(errorThrown);
    }
});

其中 jqXHR 物件有四個常用屬性:

readyState:目前狀態。0 未初始化、1 正在載入、2 已載入、3 資料交互中、4 完成。
status:HTTP 狀態碼,例如 404、500。
statusText:狀態碼對應的描述,404 是 Not Found、500 是 Internal Server Error。
responseText:伺服器回應的原始文字內容。

textStatus 與 errorThrown 都是字串,前者是狀態描述,後者是錯誤訊息。

實務上的排查順序很簡單:先把 textStatus 和 jqXHR.readyState 印出來,通常就已經能判斷方向;若仍不清楚,再把 jqXHR.responseText 也印出來看伺服器究竟回了什麼。

案例一:parsererror

現象:後端是 PHP + MySQL,ajax 以 POST 送出 JSON 物件,textStatus 顯示 parsererror。

分析:parsererror 代表請求其實已經成功往返,伺服器也回應了內容,問題出在前端解析這段回應時失敗。此時要做的就是把回應原文抓出來看,有兩個方法:印出 jqXHR.responseText,或開啟瀏覽器開發者工具的 Network 面板直接檢視。

這個案例中看到的是 5{"status":"success"} 這種內容——裡面確實有 JSON 資料,但前面多了一個字符,整體不是合法的 JSON。回頭檢查 PHP 檔案,把多餘的輸出移除即可。另一個常見原因是使用單引號,例如 {'status':'success'},這同樣不是合格 JSON,必須改用雙引號。

案例二:兩邊回呼都沒進去

現象:後端是 Node.js,ajax 送出後既沒進 success,也沒進 error,完全沒有回應。

分析:先確認功能是否已完成。這個案例中資料庫其實已經被正確修改了,也就是說後端邏輯沒問題,只是處理完之後沒有把結果寫回應答。補上 res 回應即可。

這個案例帶出一個重要觀念:ajax 收到的錯誤狀態碼,基本上都來自後端。如果連狀態碼都沒有,通常代表連線層或後端根本沒回話,而不是前端出了差錯。

排查心得

遇到 ajax 報錯,先別急著改前端程式碼。判斷順序是:有沒有回應 → 回應內容是否合法 → 內容是否符合預期。三個問題各自對應完全不同的修改位置,先定位再動手,能省下不少時間。

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