jQuery $.ajax() 是所有高層 AJAX 方法($.get、$.post、$.getJSON 等)的底層實現。掌握其完整參數選項,能精準控制請求行為、解決緩存、亂碼、跨域等疑難雜症。本文系統整理核心參數、常見陷阱與最佳實踐。
1. GET vs POST:核心差異與選擇原則
| 維度 | GET | POST |
| 語義 | 獲取資源,冪等、可緩存 | 提交/修改資源,非冪等 |
| 參數傳遞 | URL QueryString(長度限制 ~2KB) | Request Body(理論無上限) |
| 瀏覽器緩存 | 預設緩存(IE 強緩存) | 預設不緩存 |
| 安全性 | 參數暴露於 URL/歷史/日誌 | 參數在 Body,相對隱蔽 |
| 適用場景 | 查詢、列表、靜態資源 | 新增、修改、刪除、大數據提交 |
原則:查詢用 GET,變更用 POST。若 GET 參數含敏感信息或超長,強制改 POST。
2. $.ajax() 核心參數速查表(高頻項)
| 參數 | 類型 | 預設值 | 關鍵說明 |
| url | String | 當前頁 | 請求地址 |
| type | String | 'GET' | 'GET' 或 'POST',亦支援 PUT/DELETE(瀏覽器兼容性自測) |
| data | Object/String | — | 發送數據。Object 自動序列化為 key=val&...;String 直接發送 |
| dataType | String | 自動判斷 | 'xml','html','script','json','jsonp','text'。指定後 jQuery 依此解析響應 |
| cache | Boolean | true(GET) | false 時在 URL 附加 _=timestamp 參數,繞過瀏覽器緩存 |
| async | Boolean | true | false 為同步請求(阻塞 UI,慎用) |
| timeout | Number | 0(無限) | 毫秒數,超時觸發 error 回調 |
| contentType | String | 'application/x-www-form-urlencoded; charset=UTF-8' | 發送編碼類型。發送 JSON 時改為 'application/json; charset=utf-8' |
| processData | Boolean | true | false 時不序列化 data,直接發送(如 FormData、XML、JSON 字串) |
| beforeSend | Function(xhr) | — | 發送前修改 XHR,如設置自定義 Header、Token |
| success | Function(data, status, xhr) | — | 請求成功回調 |
| error | Function(xhr, status, err) | — | 請求失敗回調 |
| complete | Function(xhr, status) | — | 完成回調(成功/失敗均執行) |
3. 緩存控制最佳實踐
- 查詢介面:
type:'GET', cache:true(配合後端 Cache-Control),或手動加 _t:Date.now() 強制刷新。
- 變更介面:
type:'POST', cache:false(預設即 false)。
- 全域關閉 GET 緩存:
$.ajaxSetup({cache:false}),但需注意靜態資源(模板、配置)需單獨開啟緩存。
4. 亂碼問題根因與解決
| 現象 | 原因 | 解決 |
| 中文參數發送亂碼 | GET 參數未 encodeURIComponent | 手動 encodeURIComponent(val) 或改用 POST |
| 響應中文亂碼 | 響應頭無 charset 或 charset 不匹配 | 後端設置 Content-Type: application/json; charset=utf-8;前端頁面 <meta charset="utf-8"> |
| POST 發送 JSON 亂碼 | contentType 未設為 application/json | contentType:'application/json; charset=utf-8', data: JSON.stringify(obj) |
5. 完整範例:帶 Token 驗證、錯誤統一處理、Loading 狀態
$.ajax({
url: '/api/users',
type: 'POST',
dataType: 'json',
contentType: 'application/json; charset=utf-8',
data: JSON.stringify({ name: 'Tom', age: 28 }),
timeout: 8000,
beforeSend: function (xhr) {
xhr.setRequestHeader('Authorization', 'Bearer ' + getToken());
$('#loading').show();
},
success: function (res) {
if (res.code === 0) renderUser(res.data);
else showError(res.msg);
},
error: function (xhr, status, err) {
var msg = status === 'timeout' ? '請求超時' : '網絡異常:' + err;
showError(msg);
},
complete: function () {
$('#loading').hide();
}
});
6. 常見坑點提醒
dataType:'jsonp' 時,type 強制為 GET,cache 預設 false。
data 為 Object 時,jQuery 會用 $.param() 序列化,數組會展開為 key=val1&key=val2;若後端需接收數組,確保命名一致(如 ids[] 或 ids)。
- 跨域請求需後端支援 CORS(
Access-Control-Allow-Origin),或使用 JSONP(僅 GET)。
- 同步請求 (
async:false) 已被標準棄用,會阻塞主線程,嚴禁生產環境使用。
熟練掌握 $.ajax() 參數,是前端工程師處理網絡層疑難雜症的基石。