專案裡原本沒有統一的上傳函式,每處各寫各的。想說順手整理一版,於是打算做個 ajax 非同步上傳——這技術其實很老了。打開博客園輕鬆找到一篇參考文章,依葫蘆畫瓢把程式碼全改完,進度看起來相當美好。
然後把程式發布到伺服器,上傳就失效了。當場冒汗。都是偷懶抄來沒細看造成的惡果。
回去重讀那篇參考文章,作者其實早就寫明了:這個做法只能在本地使用,不能發布到伺服器。原因是它利用了某些瀏覽器對本機檔案路徑的寬鬆處理,部署後路徑解析規則一變就失效。
難道非得退回 iframe + http post 這種土辦法?不甘心,於是換 Google 全球搜索,最終找到了 jquery.form.js。
瀏覽器的安全模型不允許 XHR 直接上傳檔案——XMLHttpRequest 從一開始就不支援 multipart/form-data。常見的繞道方式是用隱藏 iframe 配合表單 submit,模擬出非同步的假象。jquery.form.js 就是把這套 iframe 手法(以及較新瀏覽器上的 FormData 支援)封裝成 ajaxSubmit(),讓呼叫端寫起來和一般 ajax 一樣。
第一步,引入 jQuery,再引入 jquery.form.js。
第二步,建立一個 .ashx 一般處理常式接收檔案。
前端程式碼:
<script src="<%=Url.Content("~/Scripts/jquery-1.4.1.js") %>" type="text/javascript"></script>
<script src="<%=Url.Content("~/Scripts/jquery.form.js") %>" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$("#btnUpload").click(function () {
if ($("#flUpload").val() == "") {
alert("請選擇一個圖片文件,再點擊上傳。");
return;
}
$('#UpLoadForm').ajaxSubmit({
success: function (html, status) {
var result = html.replace("<pre>", "").replace("</pre>", "");
$("#image").attr('src', result);
alert(result);
}
});
});
});
</script>
後端 ashx:
namespace TestMvc.Utility
{
public class PicUploadHander : IHttpHandler
{
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "text/plain";
// TODO: 驗證上傳權限
try
{
string fileNamePath = context.Request.Files[0].FileName;
string savedFileResult = UpLoadImage(fileNamePath, context);
context.Response.Write(savedFileResult);
}
catch
{
context.Response.Write("上傳提交出錯");
}
}
public bool IsReusable { get { return false; } }
}
}
整個流程是:ajax 非同步送出表單 → ashx 存檔並回傳圖片的相對路徑 → 前端回呼把該路徑塞進 <img> 的 src。相比傳統「送出後整頁刷新」的上傳方式,使用者體驗明顯更好。
程式碼裡那兩行 replace("<pre>", "") 不是多餘的。某些伺服器/IIS 設定下,ashx 或一般處理常式的純文字輸出會被包上一層 <pre> 標籤(瀏覽器對 text/plain 回應的呈現方式所致),不清掉就會把標籤當成圖片路徑的一部分,圖片自然顯示不出來。較穩妥的做法是在 ashx 明確設定 context.Response.ContentType = "text/plain",並在前端用 dataType: "text" 指定回應型別,而不是事後用字串取代去補。
這個範例能跑,但直接上線風險很高。
一、副檔名與內容型別驗證。只檢查「有沒有選檔」等於完全開放。必須建立副檔名白名單(.jpg/.png/.gif),並且檢查檔案的實際內容——單看副檔名可以偽造,應該比對 magic number 或後端重新解碼驗證。
二、檔案大小限制。既要設 maxRequestLength/maxAllowedContentLength(伺服器層),也要在 JS 端先檢查 file.size 給出即時回饋,避免使用者等半分鐘才看到錯誤。
三、檔名不可直接使用。context.Request.Files[0].FileName 完全來自用戶端,可能包含 ../ 路徑跳脫或中文編碼問題。應改用伺服器端產生的 GUID 作為實際檔名,原始檔名另行記錄在資料庫。
四、儲存位置不可在 Web 可執行目錄內。存檔資料夾應禁止執行(IIS 中設定「請求處理常式 → 移除 Script 對應」),否則一旦驗證被繞過,上傳的檔案就可能被當成程式執行。
範例程式下載(Firefox 下測試通過):https://xiazai.jb51.net/201011/yuanma/AjaxUploadPic.rar
順帶一提,如果不需要舊版 IE 相容,現代瀏覽器可直接用 FormData 搭配 $.ajax(記得設 processData: false 與 contentType: false),並能用 XMLHttpRequest.upload.onprogress 取得上傳進度百分比,比 iframe 方案勝出不少。