建立XMLHttpRequest物件並以POST方式向後端傳資料時,有一個設定不能省:
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
少了它,後端很可能完全收不到你送出的值。
最直接的方式是打開開發者工具看請求內容。
錯誤的樣子:資料出現在 Request Payload 區塊,這通常意味著Content-Type沒有正確設定。

正確的樣子:資料出現在 Form Data 區塊。

這個設定其實與HTML表單的 enctype 屬性同源——兩者都在規範「資料送到伺服器前應該如何編碼」。enctype共有三種取值(完整定義可參考W3C文件):
<form enctype="application/x-www-form-urlencoded"></form>
其中 application/x-www-form-urlencoded 正是AJAX POST最常用的一種;上傳檔案時才需要改為 multipart/form-data。
如果用的是jQuery,可以靠 serialize() 把表單參數一次打包成 id=值&name=值 的字串形式,再交給 $.ajax() 送出:
var params = $('#myForm').serialize();
$.ajax({
type: 'POST',
url: 'save.aspx',
data: params,
success: function(res){ console.log(res); }
});
使用jQuery時其實不必手動設Content-Type——它預設就會帶上正確的值,這也是為什麼這個坑在原生寫法下特別容易踩到。