幫人看程式碼時遇到一個小狀況:用 jQuery 上傳帶有檔案的表單一直失敗。原因不難找,但文件散在兩處,記錄下來以後翻閱方便。
上傳檔案時我們會用 FormData 包裝表單資料。但 jQuery 預設會對傳進 data 的內容做序列化處理,而 FormData 沒辦法被這樣加工,於是就丟出 Illegal invocation。
解法是在 $.ajax 的參數裡明確關掉這個行為:
processData: false
官方文件的原文說明如下:

預設情況下,jQuery 送出的請求頭是 application/x-www-form-urlencoded; charset=UTF-8,也就是我們熟悉的 a=A&b=B 這種查詢字串格式。檔案上傳用的是 multipart/form-data,格式完全不同,硬套就會出錯。
更關鍵的是:multipart 請求的 Content-Type 開頭帶有一個 boundary 參數,瀏覽器會依實際資料內容自動產生。如果我們自己寫死這個標頭,boundary 就會跟 body 裡的分隔符號對不上,伺服器一樣解析不出來。所以正確做法是加上 contentType: false,讓瀏覽器自行決定:
contentType: false
若是 jQuery 版本低於 1.6(不支援設成 false),則得手動指定為 multipart/form-data。相關說明見文件:

var formData = new FormData();
formData.append("file", $("#fileInput")[0].files[0]);
formData.append("name", $("#nameInput").val());
$.ajax({
url: "/api/upload",
type: "POST",
data: formData,
processData: false, // 別讓 jQuery 加工 FormData
contentType: false, // 讓瀏覽器自動補上 boundary
success: function (res) { console.log(res); },
error: function (err) { console.error(err); }
});
以前我習慣直接用原生的 XMLHttpRequest,什麼標頭都自己控制,所以從沒碰到這兩個坑。既然遇到了就補起來。一句話總結:用 FormData 上傳,processData 與 contentType 都要設 false。