WebUploader 預設送出的檔案欄位名稱不一定符合後端介面。本文記錄一次實戰中遇到的參數問題,以及最後找到的解法。
前端使用 HTML5 + Ajax,後端是 Java(Struts 相關框架)。後端同事提供的介面是 ./file/uploader.do?upFile=,也就是說檔案必須放在名為 upFile 的參數裡。但前端用的是 WebUploader,我一開始不知道該怎麼改這個欄位名稱。
翻了不少資料後,整理出兩條路。
如果介面不指定參數名稱,後端可以直接用 request.getInputStream() 以二進位方式讀取上傳內容。但使用這個方式時,前端必須把 sendAsBinary 設為 true:
var uploader = WebUploader.create({
swf: './js/webuploader/Uploader.swf',
server: common.BASE_URL_DEV + '/file/upload.do',
pick: '#picker',
duplicate: false,
resize: false,
auto: true,
fileNumLimit: 5,
sendAsBinary: true, // 以二進位方式上傳
fileSingleSizeLimit: 5242880,
accept: {
title: 'intoTypes',
extensions: 'rar,zip,doc,xls,docx,xlsx,pdf',
mimeTypes: '.rar,.zip,.doc,.xls,.docx,.xlsx,.pdf'
}
});
這個做法的缺點是後端拿不到原始檔名與 Content-Type,通常得由前端另外把這些資訊放在其他參數一起送過去。
若後端使用 commons-fileupload 這類元件接收,就維持一般的 multipart 流程,不必更動 sendAsBinary。這是多數 Java 專案的常態做法,後端同事通常已經很熟悉。
一開始我送檔案時完全沒有指定參數名,後端同事在 Tomcat 的日誌裡看到三個欄位:file、fileContentType、fileFileName。其中 file 抓到的正是我上傳的檔案內容。於是我們猜測 WebUploader 有一個預設名稱叫「file」,翻查 API 文件後證實猜測正確。

問題至此迎刃而解——只要用 fileVal 這個設定項指定名稱即可:
var uploader = WebUploader.create({
swf: './js/webuploader/Uploader.swf',
server: common.BASE_URL_DEV + '/file/upload.do',
pick: '#picker',
duplicate: false,
resize: false,
auto: true,
fileNumLimit: 5,
fileVal: "upload", // 指定欄位名稱,後端用同一名稱接收
fileSingleSizeLimit: 5242880,
accept: {
title: 'intoTypes',
extensions: 'rar,zip,doc,xls,docx,xlsx,pdf',
mimeTypes: '.rar,.zip,.doc,.xls,.docx,.xlsx,.pdf'
}
});
三個設定項各有用途:fileVal 決定檔案欄位的名稱(預設 file),sendAsBinary 決定是否以純二進位送出,而 formData 則用來附加其他自訂參數。釐清這三者的分工,大部分「後端收不到我要的參數」的問題都能迅速定位。
這次的經驗也說明:遇到元件行為不明確時,最快的排查方式就是先讓後端把收到的所有欄位名稱印出來,再回頭對照文件——比憑空猜測有效得多。