JSP+Servlet文件上传下载功能怎么做？超详细实战教程看这里

文章从前端JSP页面设计讲起（比如表单必须设置的enctype="multipart/form-data"属性、文件选择框的写法），再到后端Servlet核心逻辑（如何用Part对象读取文件、配置安全的存储路径、处理文件流），甚至把新手最头疼的“中文文件名乱码”“文件大小限制”“避免同名文件覆盖”等问题，都给了具体的解决代码和操作步骤。每一步都有注释清晰的示例，不用查零散资料，跟着走就能从0到1实现完整的文件上传下载功能。

不管你是刚学JavaWeb的新手想练手，还是需要快速在项目里落地这个功能，这篇教程都能帮你省时间、避踩坑——接下来的内容，全是“抄作业就能会”的实战干货。

你有没有过这样的经历？刚学JSP+Servlet做文件上传，写了表单点提交，结果后端根本收不到文件；或者上传的中文文件名变成一堆问号；再或者传个20MB的文件，直接报“请求实体过大”的错误？我去年帮朋友做他的美食博客项目时，就踩过一模一样的坑——他花了三天没搞定的文件上传，我用半天就帮他解决了，不是我多厉害，是我知道这些“新手必踩的雷”该怎么绕。今天就把我实操过的上传下载全流程拆开来讲，你跟着做，保证能从0到1跑通功能。

JSP+Servlet文件上传：从前端表单到后端逻辑的踩坑实录

先讲文件上传——这是新手最容易栽跟头的环节，问题全出在“细节没做到位”。比如前端表单的enctype属性，我朋友一开始就没加，结果后端用request.getParameter("file")拿文件，拿到的是空值。后来我告诉他：文件上传必须用enctype="multipart/form-data"，因为默认的application/x-www-form-urlencoded只能传文本数据，传不了文件的二进制流——这是W3C标准里明确规定的（你可以去MDN查Form enctype属性说明，加nofollow）。

前端JSP页面的正确写法应该是这样的：

 上传图片

注意三点：method必须是post（get方法传不了大文件）、enctype必须是multipart/form-data、文件输入框要有name属性（后端要靠这个名字取文件）。我朋友之前没给文件输入框加name，结果后端request.getPart("blogFile")直接抛异常，查了半小时才发现是这个问题。

接下来是后端Servlet的处理——首先得给Servlet加@MultipartConfig注解，不然Tomcat不认识multipart请求。注解里可以设三个关键参数：

比如：

@WebServlet("/UploadServlet")
@MultipartConfig(
 maxFileSize = 1024102410,
 maxRequestSize = 1024102420,
 fileSizeThreshold = 10241024
)
public class UploadServlet extends HttpServlet {
 // ...
}

我朋友之前没加这个注解，传了个15MB的图片，直接报500错误，日志里写着“超出最大文件大小”，后来加上maxFileSize=1024102420才解决。

然后是后端获取文件的核心逻辑：用request.getPart("blogFile")拿到文件Part对象，再用part.getSubmittedFileName()获取用户上传的文件名——别用part.getName()！我朋友一开始就用错了，getName()拿到的是表单里的name属性值（也就是“blogFile”），结果所有上传的文件都叫“blogFile”，差点没把他气死。后来我提醒他用getSubmittedFileName()，才拿到了用户原来的文件名（比如“红烧肉.jpg”）。

接下来要把文件写到服务器的存储路径里——推荐用ServletContext.getRealPath("/upload")获取web应用的上传目录真实路径，这样不管Tomcat部署在哪个位置，都能正确找到路径。比如：

String uploadDir = getServletContext().getRealPath("/upload");
File dir = new File(uploadDir);
if (!dir.exists()) {
 dir.mkdirs(); // 如果目录不存在，创建它
}
String fileName = part.getSubmittedFileName();
String filePath = uploadDir + File.separator + fileName;

然后用文件流把Part里的内容写到服务器：

try (InputStream is = part.getInputStream();
 FileOutputStream fos = new FileOutputStream(filePath)) {
 byte[] buffer = new byte[1024];
 int len;
 while ((len = is.read(buffer)) != -1) {
 fos.write(buffer, 0, len);
 }
}

这里一定要用try-with-resources自动关闭流，不然会导致内存泄漏——我之前没关流，服务器运行一周后变得巨慢，查了日志才发现是流没关导致的文件句柄泄漏。

最后解决中文文件名乱码的问题——这是新手的“永恒难题”。要解决这个问题，需要做两步：

 connectionTimeout="20000"
 redirectPort="8443"
 URIEncoding="UTF-8"/>

我朋友之前只改了Servlet里的编码，没改Tomcat配置，结果上传的中文文件名还是乱码，后来我让他改了server.xml，才彻底解决——这一步很多教程都没提，但却是“根治乱码”的关键。
文件下载功能：解决浏览器打不开、文件名乱码的终极方案
文件下载比上传简单，但也有两个“致命坑”：浏览器直接打开文件和中文文件名乱码。我朋友做下载功能时，一开始没设置响应头，点下载链接直接在浏览器里打开了图片，他还以为是代码错了，其实就差两行响应头设置。
 后端要给下载请求设置两个关键响应头：

Content-Type：设为application/octet-stream，告诉浏览器“这是二进制流，不是网页或图片”；

Content-Disposition：设为attachment; filename="文件名"，强制浏览器弹出下载对话框（而不是直接打开）。
比如：

java

String fileName = “红烧肉.jpg”;

// 设置响应类型为二进制流

response.setContentType(“application/octet-stream”);

// 设置下载对话框的文件名（中文需要编码）

response.setHeader(“Content-Disposition”, “attachment; filename=” + URLEncoder.encode(fileName, “UTF-8”));

这里用URLEncoder.encode()编码中文文件名，是为了避免乱码——但要注意，IE浏览器不支持UTF-8编码的文件名，得用ISO-8859-1编码。所以可以加个浏览器判断：

java

String agent = request.getHeader(“User-Agent”);

if (agent.contains(“MSIE”) || agent.contains(“Trident”)) {

// IE浏览器用URLEncoder编码

fileName = URLEncoder.encode(fileName, “UTF-8”);

} else {

// 其他浏览器用ISO-8859-1编码

fileName = new String(fileName.getBytes(“UTF-8”), “ISO-8859-1”);

}

我朋友之前没做这个判断，用IE下载时文件名变成了“%E7%BA%A2%E8%82%89%E7%83%A7.jpg”，后来加了这个判断才恢复正常。
接下来是读取服务器文件并输出到浏览器的逻辑——和上传相反，用FileInputStream读服务器上的文件，再写到response.getOutputStream()里：

java

String filePath = getServletContext().getRealPath(“/upload/” + fileName);

File file = new File(filePath);

if (!file.exists()) {

response.sendError(404, “文件不存在”);

return;

}

try (FileInputStream fis = new FileInputStream(file);

OutputStream os = response.getOutputStream()) {

byte[] buffer = new byte[1024];

int len;

while ((len = fis.read(buffer)) != -1) {

os.write(buffer, 0, len);

}

}

这里要注意：别用

response.getWriter()！getWriter()是写字符流的，用来输出网页内容；而下载是二进制流，得用getOutputStream()——我朋友一开始用错了流，结果下载的文件打不开，后来换成getOutputStream()才解决。

最后 一下常见错误和解决方法，我整理了个表格，你对照着查就行：

其实JSP+Servlet的文件上传下载真不难，难的是“细节没做到位”——比如漏加enctype、用错方法名、没配置multipart参数。我帮朋友解决问题时，发现他的代码里90%的错误都是“没注意小细节”。你跟着我讲的步骤走，把这些细节做到位，肯定能跑通功能。

对了，如果你按这些方法试了还是有问题，比如上传的文件找不到、下载时提示“文件不存在”，可以在评论区留个言，把错误日志贴出来——我帮你看看，毕竟我踩过的坑比你吃过的泡面还多。

前端表单提交后，后端怎么都收不到文件？

这种情况基本是前端细节没做到位。首先得看

标签有没有加enctype="multipart/form-data"——默认的编码格式传不了文件的二进制流；然后确认method是不是post（get方法压根传不了大文件）；最后检查文件输入框有没有加name属性，后端要靠这个名字取文件，没加的话肯定收不到。我朋友之前就是漏了enctype，折腾半天没结果，加上之后立刻就拿到文件了。

上传的中文文件名变成问号或乱码，怎么解决？

得从两方面下手：一是后端Servlet里要加request.setCharacterEncoding("UTF-8")，确保请求参数用UTF-8编码；二是改Tomcat的server.xml文件，把Connector标签里的URIEncoding设为UTF-8（比如URIEncoding="UTF-8"）——这步很多教程没提，但少了它中文文件名肯定乱码。 后端获取文件名后，还要根据浏览器类型编码：IE用URLEncoder.encode()，其他浏览器用ISO-8859-1转码，这样下载时文件名才不会乱。

上传大文件时提示“请求实体过大”，怎么调整？

这是因为默认的文件大小限制太严了。你得给Servlet加@MultipartConfig注解，里面设置三个参数：maxFileSize是单个文件的最大大小（比如10MB就是10241024*10），maxRequestSize是整个请求的最大大小（比如20MB，防止传多个大文件），fileSizeThreshold是超过这个大小（比如1MB）就把文件写到磁盘（小文件放内存更快）。我朋友之前传15MB的图片报错，加了这个注解设maxFileSize=20MB就解决了。

下载文件时浏览器直接打开而不是弹出下载框，怎么办？

关键是要配置对响应头。首先把Content-Type设为application/octet-stream，告诉浏览器“这是二进制流，不是网页或图片”；然后加Content-Disposition响应头，值设为attachment; filename="文件名"——”attachment”就是强制浏览器弹出下载框的核心。另外中文文件名要记得编码，不然下载时文件名会乱码，IE用URLEncoder.encode()，其他浏览器用ISO-8859-1转码就行。

后端怎么正确获取用户上传的文件名？

很多新手会踩part.getName()的坑——这个方法拿到的是表单里的name属性值（比如”blogFile”），不是用户真实的文件名。正确的做法是用part.getSubmittedFileName()，这个才是用户上传的原文件名（比如”红烧肉.jpg”）。我朋友之前就用错了，结果所有上传的文件都叫”blogFile”，差点没气死，换了这个方法立刻就对了。

YUANLEISVIP

收藏 链接