萬盛學電腦網

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

jQuery AJAX error 回呼觸發原因與 async:false 解決方案

現象

明明伺服器回傳 200 OK,卻進入 error 回呼,textStatus 顯示 parsererror。

原因一:非同步競態導致資料未就緒

預設 async: true,若後續程式碼依賴 AJAX 回傳資料,卻在請求完成前執行,會造成邏輯錯誤。設定 async: false 強制同步等待:

$.ajax({
    type: 'POST',
    async: false, // 同步請求(注意:會阻塞 UI,慎用)
    url: urllink,
    data: data,
    dataType: 'html',
    success: function(msg) { alert(msg); },
    error: function(xhr, status, err) {
        console.log(xhr.status, xhr.readyState, status, err);
    }
});
警告:async: false 已被標準棄用,會凍結瀏覽器主執行緒。現代專案請改用 Promise/async-await 或回呼/事件機制處理非同步流程。

原因二:data: "{}" 未正確傳遞空物件

若不需傳參數,必須傳 data: "{}" 或 data: {},否則 jQuery 可能送出空字串,導致伺服器回傳非預期格式(如 XML 錯誤頁),引發 parsererror。

// ❌ 易出錯
$.ajax({ dataType: 'json', data: '', ... });

// ✅ 正確
$.ajax({ dataType: 'json', data: {}, ... }); // 或 data: '{}'

完整錯誤資訊檢查

error: function(xhr, textStatus, errorThrown) {
    console.group('AJAX Error');
    console.log('status:', xhr.status);        // HTTP 狀態碼
    console.log('readyState:', xhr.readyState); // 0-4
    console.log('textStatus:', textStatus);     // timeout, error, abort, parsererror
    console.log('errorThrown:', errorThrown);   // 例外物件或字串
    console.log('responseText:', xhr.responseText); // 原始回應
    console.groupEnd();
}

常見 textStatus 對照

值含義
timeout請求逾時
errorHTTP 錯誤 (4xx, 5xx)
abort請求被中止
parsererror資料解析失敗 (JSON/XML 格式錯誤)

建議處理流程

  1. 先在 Network 面板確認 Response 內容是否為合法 JSON/HTML。
  2. 若為 parsererror,檢查 dataType 與實際回傳是否匹配。
  3. 若為非同步時序問題,改用 $.ajax().done(fn).fail(fn) 鏈式寫法或 await $.ajax(...)(需 Promise 封裝)。
  4. 後端錯誤時也回傳 JSON { success: false, msg: '...' },前端統一在 success 判斷 data.success,避免進入 error。
copyright © 萬盛學電腦網 all rights reserved