parsererror 是 Ajax 中很常見但原因廣泛的錯誤。有時即使 HTTP 狀態是 200、readyState 是 4,前端仍會進入 error 分支。這通常代表瀏覽器無法把回應解析成預期格式,或跨網域流程中有某些細節不符合規範。
可在 error 回呼中輸出 textStatus、XMLHttpRequest.status、readyState 與 responseText,藉此判斷是網路問題、伺服器錯誤,還是資料格式問題。
error: function (XMLHttpRequest, textStatus, errorThrown) {
console.log(textStatus);
console.log(XMLHttpRequest.status);
console.log(XMLHttpRequest.readyState);
console.log(XMLHttpRequest.responseText);
}
第一,伺服器回傳的 JSON 格式不標準,例如使用單引號、尾端逗號或缺少雙引號。第二,dataType 指定錯誤,例如預期 json 但實際回傳 HTML 或純文字。第三,跨網域 JSONP 回傳格式不正確,callback 函式後缺少分號,或多個請求併發時造成解析異常。
若使用 JSONP,伺服器應回傳類似 callback 函式呼叫的格式,並在最後加上分號。若同一頁面有多個請求,且回應順序或格式不一致,容易引發難以察覺的錯誤。
跨網域請求若沒有資料要送,建議明確送出空物件,而不是留空。部分舊版 jQuery 或瀏覽器在處理空白資料與跨網域請求時,可能出現非預期行為。
正式開發時,應先確認後端回傳的 Content-Type、編碼與資料格式是否正確,再檢查前端 dataType 是否相符。只要資料格式、標頭與請求方式一致,parsererror 通常就能避免。