在Java应用中实现文件上传到服务器是一项常见需求，广泛应用于系统配置、用户头像、附件上传等场景，整个过程涉及客户端文件选择、网络传输、服务器接收与存储等多个环节，需要综合考虑安全性、性能和易用性,以下是详细的实现步骤和关键代码示例。
（图片来源网络，侵删）
文件上传的基本流程
文件上传通常基于HTTP协议实现，客户端通过表单提交文件数据，服务器端解析请求并保存文件，核心步骤包括：客户端构建请求、服务器端接收文件、文件校验与存储，常见的实现方式有两种：传统Servlet API和第三方框架（如Apache Commons FileUpload）。
客户端实现（HTML + JavaScript）
客户端需要构建一个包含文件输入框的表单，并设置正确的编码类型（enctype="multipart/form-data"）,以下是基础HTML示例：
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="file" />
<button type="submit">上传</button>
</form>
若需通过JavaScript动态提交（如AJAX），可使用FormData对象：
const formData = new FormData();
formData.append("file", fileInput.files[0]);
fetch("/upload", {
method: "POST",
body: formData
}).then(response => response.json());
服务器端实现（Java Servlet）
传统Servlet API（Java 6+）
对于简单场景，可直接使用HttpServletRequest的getPart()方法（需Servlet 3.0+）：
（图片来源网络，侵删）
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
Part filePart = request.getPart("file");
String fileName = filePart.getSubmittedFileName();
InputStream fileContent = filePart.getInputStream();
// 保存文件到服务器
Path uploadPath = Paths.get("/uploads");
if (!Files.exists(uploadPath)) {
Files.createDirectories(uploadPath);
}
Files.copy(fileContent, uploadPath.resolve(fileName), StandardCopyOption.REPLACE_EXISTING);
}
注意：需在web.xml中配置multipart-config或通过注解@MultipartConfig启用。
使用Apache Commons FileUpload（兼容旧版本）
对于Servlet 2.5或需要更复杂控制的情况,可引入依赖：
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
核心代码：
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
List<FileItem> items = upload.parseRequest(request);
for (FileItem item : items) {
if (!item.isFormField()) {
String fileName = new File(item.getName()).getName();
item.write(new File("/uploads/" + fileName));
}
}
关键配置与优化
服务器端配置
- 文件大小限制：在
web.xml中设置：<multipart-config> <max-file-size>10485760</max-file-size> <!-- 10MB --> <max-request-size>52428800</max-request-size> <!-- 50MB --> </multipart-config> - 存储路径：避免使用绝对路径，建议通过ServletContext获取相对路径：
String realPath = getServletContext().getRealPath("/uploads");
安全性处理
- 文件名校验：防止路径遍历攻击（如
../../../etc/passwd）：String safeFileName = Paths.get(fileName).getFileName().toString();
- 文件类型校验：通过文件头或扩展名限制允许的类型：
String contentType = filePart.getContentType(); if (!contentType.startsWith("image/")) { throw new IllegalArgumentException("仅支持图片文件"); }
性能优化
- 临时文件处理：大文件可先存到临时目录,处理完成后移动到目标位置。
- 异步上传：对于耗时操作，建议使用线程池或消息队列（如RabbitMQ）解耦。
常见问题与解决方案
文件上传失败的可能原因及排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 返回413 Request Entity Too Large | 文件大小超过限制 | 检查max-file-size配置 |
| 中文文件名乱码 | 请求编码不一致 | 设置request.setCharacterEncoding("UTF-8") |
相关问答FAQs
Q1: 如何在上传进度条？
A1: 可通过XMLHttpRequest的upload.onprogress事件或fetch的ReadableStream实现前端进度监听，服务器端需分块读取文件并返回已处理字节数,前端代码：
const xhr = new XMLHttpRequest();
xhr.upload.onprogress = (event) => {
if (event.lengthComputable) {
const percent = (event.loaded / event.total) * 100;
console.log(`上传进度: ${percent}%`);
}
};
Q2: 如何支持大文件分片上传？
A2: 前端将文件切分为多个块（如每块5MB），分别上传并携带文件唯一标识，服务器端接收后按顺序合并，需额外实现以下逻辑：
- 前端：使用
Blob.slice()分片，并记录当前分片索引。 - 服务器端：创建临时文件，按顺序写入分片数据，完成后重命名为正式文件。
- 断点续传：通过记录已上传的分片索引,实现中断后恢复上传。
