萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

AJAX POST 表單提交 setRequestHeader 報錯根因與標準解決方案

原生 XMLHttpRequest 發送 POST 請求時,若未正確設置 Content-Type,後端無法解析請求體 (顯示為 Request Payload 而非 Form Data),導致參數為空。本文解析根因與標準修復姿勢。

問題現象

  • Chrome DevTools Network 面板 → Request 標籤:數據顯示在 Request Payload (原始 JSON/文本),而非 Form Data (鍵值對列表)。
  • 後端 (PHP $_POST、Java request.getParameter()、Node body-parser urlencoded) 讀取不到參數。
錯誤:Request Payload 顯示
正確:Form Data 顯示

根因

瀏覽器根據 Content-Type 決定如何解析/展示請求體:

  • application/x-www-form-urlencoded → 解析為鍵值對 → Form Data (表單默認)。
  • application/json → 視為原始文本 → Request Payload。
  • multipart/form-data → 文件上傳。
  • 未設置 → 瀏覽器默認發送為 text/plain;charset=UTF-8,後端多不解析。

標準修復代碼

var xhr = new XMLHttpRequest();
xhr.open('POST', '/api/submit', true);
// 關鍵:發送 send() 前設置
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');

// 數據必須序列化為 key=val&key2=val2 格式
var data = 'username=' + encodeURIComponent(username) + '&password=' + encodeURIComponent(password);
// 或使用 FormData (自動設置 multipart, 不需手動 setRequestHeader)
var formData = new FormData();
formData.append('username', username);
formData.append('password', password);
xhr.send(formData); // 瀏覽器自動設置 multipart/form-data 及 boundary

jQuery 簡化 (自動處理)

$.ajax({
  url: '/api/submit',
  type: 'POST',
  data: { username: 'test', password: '123' }, // 普通對象,jQuery 自動 serialize 為 urlencoded
  contentType: 'application/x-www-form-urlencoded; charset=UTF-8', // 可省略 (默認)
  success: function(res) { ... }
});

// 或手動序列化
var params = $('#formId').serialize(); // "username=test&password=123"
$.post('/api/submit', params, function(res){ ... });

常見錯誤姿勢

錯誤代碼問題修正
xhr.send({a:1})對象直接發送 → [object Object]JSON.stringify + 設置 application/json,或序列化為 urlencoded
xhr.setRequestHeader('Content-Type', 'application/json') 但發送 a=1&b=2類型與數據格式不匹配統一:JSON 發 JSON,表單發 urlencoded
設置 Content-Type 後又用 FormData覆蓋了瀏覽器自動生成的 multipart/form-data; boundary=...用 FormData 時**不要**手動設置 Content-Type

後端接收對照

Content-TypePHPJava (Servlet)Node (Express)Python (Flask)
application/x-www-form-urlencoded$_POSTrequest.getParameter()express.urlencoded() → req.bodyrequest.form
application/jsonjson_decode(file_get_contents('php://input'), true)request.getInputStream() + Jacksonexpress.json() → req.bodyrequest.get_json()
multipart/form-data$_FILES + $_POSTrequest.getPart() (Servlet 3.0+)multer()request.files + request.form

**黃金法則:前端發什麼格式,後端就用對應解析器;Content-Type 必須與實際發送格式精確匹配。**

copyright © 萬盛學電腦網 all rights reserved