檔案上傳是表單中少數需要特殊處理的類型。除了前端要設定 enctype,後端也需要用對應的 API 才能正確接收。以下示範單檔上傳的完整流程。
關鍵是 method="post" 與 enctype="multipart/form-data",兩者缺一都收不到檔案。
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> <% String path=request.getContextPath(); request.setAttribute("path", path); %> </head> <body> <form action="${path}/FileSer" method="post" enctype="multipart/form-data"> <table> <tr> <td>上傳文件</td> <td> <input type="file" name="fileN" /> </td> </tr> <tr> <td colspan="2"> <input type="submit" /> <input type="reset" /> </td> </tr> </table> </form> </body> </html>
package com.ser; import java.io.IOException; import javax.servlet.Filter; import javax.servlet.FilterChain; import javax.servlet.FilterConfig; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class Filter01 implements Filter { @Override public void destroy() { } @Override public void doFilter(ServletRequest arg0, ServletResponse arg1, FilterChain arg2) throws IOException, ServletException { HttpServletRequest request= (HttpServletRequest)arg0; HttpServletResponse response=(HttpServletResponse)arg1; request.setCharacterEncoding("utf-8"); response.setCharacterEncoding("utf-8"); response.setContentType("text/html charset=utf-8"); arg2.doFilter(request, response); } @Override public void init(FilterConfig arg0) throws ServletException { } }
Servlet 3.0 之後引入了 @MultipartConfig 註解與 Part 介面,不必再引入 commons-fileupload 這類第三方套件。
package com.ser; import java.io.File; import java.io.IOException; import javax.servlet.ServletConfig; import javax.servlet.ServletException; import javax.servlet.annotation.MultipartConfig; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.Part; /** * Servlet implementation class FileSer */ @WebServlet("/FileSer") @MultipartConfig(location="e://uploadFile", fileSizeThreshold=1024*1024*1000, maxFileSize=1024*1024*1000, maxRequestSize=1024*1024*1024 ) public class FileSer extends HttpServlet { private static final long serialVersionUID = 1L; private static final String location="e://uploadFile"; /** * @see HttpServlet#HttpServlet() */ public FileSer() { } @Override public void init(ServletConfig config) throws ServletException { File file =new File("e://uploadFile"); if(!file.exists()&& !file.isDirectory()) { file.mkdir(); } } /** * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response) */ protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { } /** * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response) */ protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { Part part= request.getPart("fileN"); String fileType=part.getContentType(); String fileHeader=part.getHeader("content-disposition"); //String fileName=part.getName(); long size=part.getSize(); System.out.println(part); System.out.println(fileType); System.out.println(fileHeader); //System.out.println(fileName); System.out.println(size); String filename=fileHeader.substring(fileHeader.indexOf("filename=")+10, fileHeader.lastIndexOf("\"")); part.write(filename); response.getWriter().print(filename+"上傳成功"); } }
location 是暫存目錄;fileSizeThreshold 是寫入磁碟的門檻,超過這個大小的內容才會落地成檔案,之內則留在記憶體;maxFileSize 限制單檔大小;maxRequestSize 限制整個請求的大小,多檔上傳時後者才會先被觸發。
程式用字串切割從 content-disposition 標頭中取出檔名,這麼做是因為不同瀏覽器(尤其是舊版 IE)送出的標頭格式略有差異,格式可能是 filename="xxx" 也可能夾帶完整路徑。實務上更穩健的做法是先用 indexOf("filename=") 定位後,再用 lastIndexOf("/") 或 lastIndexOf("\\") 把路徑部分去掉,只留純檔名。
直接用使用者上傳的原始檔名寫檔有明確風險,正式環境務必做到以下幾點:
1. 檔名不可信。應改用 UUID 或流水號重新命名,原始檔名另外存入資料庫。這能避免 ../../ 這類路徑穿越攻擊,也能防止中文名稱造成的編碼問題。
2. 副檔名要白名單驗證。只允許預期的格式(如 jpg、png、pdf),不要試圖用黑名單排除危險檔名,繞過方式太多。
3. 檢查實際內容類型。副檔名可以偽造,因此除了看 getContentType(),還應比對檔案的 magic number(例如 JPEG 開頭是 FF D8 FF)。
4. 上傳目錄不可執行。存放檔案的目錄應關閉腳本執行權限,避免上傳的檔案被當成程式執行。
5. 限制大小。範例中的上限設到 1GB,實際上應該依需求盡量壓低,並在伺服器層(如 Nginx 的 client_max_body_size)同步限制,否則容易被大量大檔打爆磁碟。
檔案上傳的技術門檻不高,難的是把邊界條件與安全防護想清楚。把上述幾點落實之後,這個功能才能放心用在正式環境中。