原生 XMLHttpRequest 發送 POST 請求時,若未正確設置 Content-Type,後端無法解析請求體 (顯示為 Request Payload 而非 Form Data),導致參數為空。本文解析根因與標準修復姿勢。
$_POST、Java request.getParameter()、Node body-parser urlencoded) 讀取不到參數。

瀏覽器根據 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
$.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-Type | PHP | Java (Servlet) | Node (Express) | Python (Flask) |
|---|---|---|---|---|
| application/x-www-form-urlencoded | $_POST | request.getParameter() | express.urlencoded() → req.body | request.form |
| application/json | json_decode(file_get_contents('php://input'), true) | request.getInputStream() + Jackson | express.json() → req.body | request.get_json() |
| multipart/form-data | $_FILES + $_POST | request.getPart() (Servlet 3.0+) | multer() | request.files + request.form |
**黃金法則:前端發什麼格式,後端就用對應解析器;Content-Type 必須與實際發送格式精確匹配。**