用 $http 發 POST 請求時,後端若期望的是傳統表單格式(application/x-www-form-urlencoded),直接傳物件是行不通的——Angular 預設會把它序列化成 JSON,後端收到的 body 就完全對不上。
解法是覆寫 $httpProvider.defaults.transformRequest,把物件轉成 query string 形式的字串。
var httpPost = function ($httpProvider) {
/*******************************************
說明:$http 的 post 提交時,修正消息體格式
********************************************/
// 改用 x-www-form-urlencoded
$httpProvider.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded;charset=utf-8';
/*
* 把物件轉為 x-www-form-urlencoded 序列化字串
* @param {Object} obj
* @return {String}
*/
var param = function (obj) {
var query = '', name, value, fullSubName, subName, subValue, innerObj, i;
for (name in obj) {
value = obj[name];
if (value instanceof Array) {
// 陣列:序列化成 name[0]=xx&name[1]=xx
for (i = 0; i < value.length; ++i) {
subValue = value[i];
fullSubName = name + '[' + i + ']';
innerObj = {};
innerObj[fullSubName] = subValue;
query += param(innerObj) + '&';
}
}
else if (value instanceof Object) {
// 巢狀物件:name[key]=xx
for (subName in value) {
subValue = value[subName];
fullSubName = name + '[' + subName + ']';
innerObj = {};
innerObj[fullSubName] = subValue;
query += param(innerObj) + '&';
}
}
else if (value !== undefined && value !== null) {
query += encodeURIComponent(name) + '=' + encodeURIComponent(value) + '&';
}
}
return query.length ? query.substr(0, query.length - 1) : query;
};
// 覆寫 $http 服務的預設 transformRequest
$httpProvider.defaults.transformRequest = [function (data) {
return angular.isObject(data) && String(data) !== '[object File]'
? param(data)
: data;
}];
};
var ngApp = angular.module('wtApp', ['ngCookies'], httpPost);
$http({
method: 'POST',
url: 'GetData.ashx',
params: { id: '1002' }, // params 會被拼到 URL 後面成為 query string
data: { keyName: 'qubernet' } // data 才是放在消息體中的內容
}, function (data) {
// 處理回應
});
params 與 data 完全不同。前者永遠被拼到 URL 之後(?id=1002),後者才是請求本文。這是很多人在改用 POST 後「參數收不到」的主因。
transformRequest 的執行時機。它在請求實際送出前被呼叫,因此你在這裡做的轉換會作用到所有 POST 請求。正因為是全域設定,覆寫前要確保轉換函式能容得下其他型別的資料——上例中的 String(data) !== '[object File]' 判斷就是為了讓上傳檔案的請求不被誤傷。
用 String(data) !== '[object File]' 來排除檔案物件是個取巧寫法。更準確的方式是 !(data instanceof FormData),因為實際上傳時 data 通常會是 FormData 物件而非赤裸的 File。若你的專案有檔案上傳功能,建議把條件改成同時檢查這兩者。
如果後端是你自己能掌控的,其實更省事的做法是讓後端接受 JSON——例如在 ASP.NET 中使用 [FromBody] 搭配 JSON 序列化器,或是在 Node.js 中掛上 body-parser。這樣就不必在前端做這層轉換,也避免了自製序列化函式可能出現的邊界問題(巢狀層數過深、特殊字元、日期格式等)。