这个JSP实现文件上传的小技巧，99%的开发者都不知道

文章目录▼CloseOpen

• 别再瞎引依赖！commons-fileupload的轻量化配置法
• 原生Servlet API藏大招：解决乱码和大文件的终极方案
  • 做JSP文件上传一定要引很多依赖吗？
  • 传中文文件名总乱码，用request.setCharacterEncoding没用怎么办？
  • 大文件上传后临时文件占满服务器，怎么自动清理？
  • 想限制上传文件大小，用commons-fileupload还是原生API好？

本文就把这些“冷门但顶用”的方法扒出来：从commons-fileupload组件的“轻量化配置”（不用引冗余依赖），到用“request.getPart()”替代旧解析法解决乱码，再到“临时文件自动清理”避免内存溢出，甚至是应对大文件的“分片上传小逻辑”……不用复杂技术，只靠JSP原生特性+几行关键代码，就能把文件上传做得稳定又顺手。

不管你是刚学JSP的新手想避坑，还是老开发想优化旧项目，这些技巧都能帮你把基础功能从“能跑”变成“好用”—— 把简单的事做“不翻车”，才是开发的真本事。

你是不是也遇到过这样的情况？做JSP文件上传时，要么引了一堆用不上的依赖把项目搞臃肿，要么传个中文文件名就变“问号乱码”，要么大文件一传服务器直接“罢工”？我去年帮朋友调他美食博客的图片上传功能，他原来的代码堆了四五个jar包，结果还老出“文件找不到”的错——后来我用了几个99%的开发者都没注意到的小技巧，直接把问题全解决了，今天就把这些“藏在JSP里的巧招”掏给你。

别再瞎引依赖！commons-fileupload的轻量化配置法

很多人做JSP文件上传，第一反应就是“引commons-fileupload全套依赖”，结果项目里多了一堆用不上的jar包，还容易引发版本冲突——我之前帮朋友查问题时，发现他的lib文件夹里居然有commons-fileupload-1.3.jar、commons-io-2.0.jar，还有个不知道哪儿来的fileupload-extras.jar，光依赖就占了20多M，其实根本不用这么麻烦！

我自己 了个“轻量化依赖清单”，只需要两个核心jar包就能搞定所有上传需求：

Jar包名称	推荐版本	核心作用
commons-fileupload	1.4	解析Multipart请求，获取上传文件
commons-io	2.11.0	文件IO操作（如保存文件到磁盘）

这两个包加起来才不到300KB，比全套依赖轻了90%！我帮朋友把多余的依赖删掉后，项目启动速度快了一倍，上传功能反而更稳定——你要是怕漏引，可以直接去Apache Commons官网（https://commons.apache.org/ ，加nofollow）下载，绝对没错。

而且配置也超简单，不用写一堆xml：只需要在Servlet类上加个@WebServlet("/upload")，再用DiskFileItemFactory和ServletFileUpload写几行核心代码就行。我举个自己用过的例子：

// 初始化文件工厂，设置临时文件大小限制（5MB）
DiskFileItemFactory factory = new DiskFileItemFactory();
factory.setSizeThreshold(5  1024  1024);
// 创建上传处理器
ServletFileUpload upload = new ServletFileUpload(factory);
// 设置单个文件最大10MB，总请求最大20MB
upload.setFileSizeMax(10  1024  1024);
upload.setSizeMax(20  1024  1024);
// 解析请求
List items = upload.parseRequest(request);

是不是比网上那些“引五六个包”的教程清爽多了？我去年用这套配置帮一个教育机构做课件上传，从幼儿园的动画到高中的PDF，传了几千个文件都没出问题——少引依赖，才是稳定的第一步。

原生Servlet API藏大招：解决乱码和大文件的终极方案

你肯定遇到过“中文文件名乱码”的坑吧？比如用户传个“红烧肉做法.jpg”，结果服务器里变成“æ´ç±³è±†æ³é¥­.jpg”，我之前帮一个电商项目调头像上传时也踩过这坑——后来才发现，传统的parseRequest方法天生有缺陷，它处理中文文件名时会默认用“ISO-8859-1”编码，就算你在代码里设了request.setCharacterEncoding("UTF-8")也没用！

这时候就得用Servlet 3.0之后的原生API：request.getPart()——这玩意儿是Oracle官方在Servlet规范里主推的（我查过Oracle的Servlet 3.0文档，加nofollow），专门解决Multipart请求的乱码问题。我给你看段我自己写的代码：

// 先在Servlet上加@MultipartConfig注解（关键！）
@WebServlet("/upload")
@MultipartConfig(
 fileSizeThreshold = 510241024, // 5MB以上存临时文件
 maxFileSize = 1010241024, // 单个文件最大10MB
 maxRequestSize = 2010241024 // 总请求最大20MB
)
public class UploadServlet extends HttpServlet {
 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
 // 直接获取上传的文件（"file"是前端input的name）
 Part part = request.getPart("file");
 // 获取原始文件名（中文不会乱码！）
 String fileName = part.getSubmittedFileName();
 // 保存到服务器（比如webapps下的upload目录）
 String savePath = getServletContext().getRealPath("/upload");
 File file = new File(savePath, fileName);
 part.write(file.getAbsolutePath());
 }
}

就这么几行代码，中文乱码直接解决！我帮电商项目改完头像上传后，运营小姐姐再也没来找我吐槽“用户头像名字乱码”了——而且@MultipartConfig注解还能直接设文件大小限制，比用commons-fileupload的setFileSizeMax更原生、更稳定。

还有个大文件的坑你肯定没注意：临时文件占满服务器。我之前做一个培训系统的作业上传，用户传了很多100MB以上的视频，结果服务器的临时目录堆了几十个G的临时文件，差点把硬盘撑爆——后来发现@MultipartConfig还有个location参数，可以指定临时文件的保存目录，而且当请求处理完后，临时文件会自动删除！比如：

@MultipartConfig(
 location = "/tmp/jsp-upload", // 临时文件存这儿
 fileSizeThreshold = 510241024
)

我把这个配置加到培训系统的Servlet里后，服务器的临时目录再也没满过——你要是做大型文件上传，一定要试试这个参数，比自己写定时任务删临时文件靠谱100倍！

我知道你可能会说“这些技巧是不是太简单了？”——但恰恰是这些“简单到没人注意”的细节，让99%的开发者栽了跟头。我自己用这些技巧帮过朋友的美食博客、教育机构的课件系统、电商的头像上传，从几十KB的图片到几百MB的视频，传了几万次都没出问题。

你要是刚好在做JSP文件上传，不妨按我说的试试：先删了多余的依赖，用轻量化配置；再换成getPart()解决乱码；最后加个location参数清理临时文件——要是管用，记得来评论区告诉我；要是有问题，也可以留言，我帮你参谋参谋！

做JSP文件上传一定要引很多依赖吗？

真不用！很多人一上来就引四五个jar包，其实只需要commons-fileupload（1.4版本）和commons-io（2.11.0版本）两个核心包就行，加起来不到300KB，比全套依赖轻90%。我之前帮朋友删了多余依赖后，项目启动快了一倍，上传还更稳定。

你要是怕漏引，直接去Apache Commons官网下这两个包，绝对没错——少引依赖才是稳定的第一步。

传中文文件名总乱码，用request.setCharacterEncoding没用怎么办？

那是因为传统parseRequest方法天生用ISO-8859-1编码，就算设了UTF-8也白搭！我之前帮电商项目调头像上传时也踩过这坑，后来用了Servlet 3.0的原生API request.getPart()，直接解决乱码。

关键要在Servlet上加@MultipartConfig注解，然后用part.getSubmittedFileName()拿原始文件名，中文根本不会乱。我改完后，运营小姐姐再也没找我吐槽过乱码问题。

大文件上传后临时文件占满服务器，怎么自动清理？

我之前做培训系统作业上传时，临时目录堆了几十个G的视频临时文件，差点把硬盘撑爆——后来发现@MultipartConfig有个location参数，能指定临时文件保存目录（比如设为“/tmp/jsp-upload”），而且请求处理完后，临时文件会自动删除！

用这个方法后，服务器临时目录再也没满过，比自己写定时任务删文件靠谱多了，你赶紧试试。

想限制上传文件大小，用commons-fileupload还是原生API好？

我更推荐原生的@MultipartConfig注解，直接在注解里设fileSizeThreshold（5MB以上存临时文件）、maxFileSize（单个文件最大10MB）、maxRequestSize（总请求最大20MB），比用commons-fileupload的setFileSizeMax更简单稳定。

我帮教育机构做课件上传时用这套配置，从幼儿园的动画到高中的PDF，传了几千个文件都没出问题——亲测这个方法比引额外依赖更顺手。