在Java开发中，处理文件上传是一项常见的需求，无论是用户头像、文档资料还是其他类型文件，都需要通过代码实现服务器端的接收与存储，要实现Java获取上传文件的功能，需要结合HTTP请求解析、文件流处理以及异常机制等多个技术点，本文将从基础原理到具体实践,详细讲解Java获取上传文件的完整流程。
文件上传的基础原理
文件上传的本质是通过HTTP协议将客户端文件数据传输到服务器，在HTTP请求中，当表单的enctype设置为multipart/form-data时，浏览器会将文件拆分成多个部分，每部分包含文件头信息和文件内容，并通过POST请求发送至服务器，Java后端需要解析这种特殊的HTTP请求,从中提取出文件数据并保存到指定位置。
传统Servlet方式获取上传文件
在未使用第三方框架时，可以通过Servlet API原生实现文件上传，核心是使用HttpServletRequest的getPart()方法（Servlet 3.0+支持）或第三方库（如Apache Commons FileUpload）解析请求。
使用getPart()方法
Servlet 3.0及以上版本提供了getPart()方法，可直接获取上传的文件部分，需注意，在web.xml中配置multipart-config以支持大文件上传：
<servlet>
<servlet-name>UploadServlet</servlet-name>
<servlet-class>com.example.UploadServlet</servlet-class>
<multipart-config>
<max-file-size>10485760</max-file-size> <!-- 单文件最大10MB -->
<max-request-size>52428800</max-request-size> <!-- 总请求最大50MB -->
<file-size-threshold>2097152</file-size-threshold> <!-- 缓存阈值2MB -->
</multipart-config>
</servlet>
在Servlet中,通过以下代码获取文件：
protected void doPost(HttpServletRequest request, HttpServletResponse response) {
try {
Part part = request.getPart("file"); // "file"为前端表单input的name属性
String fileName = part.getSubmittedFileName();
String contentType = part.getContentType();
long size = part.getSize();
// 获取输入流并保存文件
InputStream inputStream = part.getInputStream();
String savePath = getServletContext().getRealPath("/uploads");
File file = new File(savePath, fileName);
Files.copy(inputStream, file.toPath(), StandardCopyOption.REPLACE_EXISTING);
response.getWriter().println("文件上传成功：" + fileName);
} catch (Exception e) {
e.printStackTrace();
}
}
使用Apache Commons FileUpload
对于较低版本的Servlet，可通过Commons FileUpload库实现,需添加依赖：
<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 = item.getName();
InputStream inputStream = item.getInputStream();
String savePath = "D:/uploads";
File file = new File(savePath, fileName);
Files.copy(inputStream, file.toPath(), StandardCopyOption.REPLACE_EXISTING);
}
}
Spring Boot框架中的文件上传
Spring Boot对文件上传提供了更简洁的支持，通过MultipartFile接口即可轻松处理文件数据。
配置文件上传参数
在application.properties或application.yml中配置上传限制：
spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=50MB spring.servlet.multipart.enabled=true
控制器层实现
创建Controller方法，接收MultipartFile参数：
@RestController
@RequestMapping("/upload")
public class FileUploadController {
@PostMapping("/file")
public String uploadFile(@RequestParam("file") MultipartFile file) {
if (file.isEmpty()) {
return "文件不能为空";
}
try {
String fileName = file.getOriginalFilename();
String savePath = "D:/spring-uploads";
File dest = new File(savePath, fileName);
// 确保目录存在
if (!dest.getParentFile().exists()) {
dest.getParentFile().mkdirs();
}
// 保存文件
file.transferTo(dest);
return "文件上传成功：" + fileName;
} catch (IOException e) {
return "文件上传失败：" + e.getMessage();
}
}
}
多文件上传处理
若需同时上传多个文件，可将参数定义为MultipartFile[]或List<MultipartFile>：
@PostMapping("/files")
public String uploadFiles(@RequestParam("files") MultipartFile[] files) {
for (MultipartFile file : files) {
if (!file.isEmpty()) {
// 保存单个文件的逻辑
}
}
return "多文件上传完成";
}
文件上传的安全与优化
文件名安全处理
直接使用用户上传的文件名可能存在安全风险（如路径穿越攻击）,需对文件名进行过滤和重命名：
String originalFilename = file.getOriginalFilename();
String safeFileName = UUID.randomUUID().toString() +
originalFilename.substring(originalFilename.lastIndexOf("."));
文件类型校验
通过getContentType()或文件后缀校验文件类型,限制允许上传的扩展名：
List<String> allowedTypes = Arrays.asList("image/jpeg", "image/png", "application/pdf");
if (!allowedTypes.contains(file.getContentType())) {
return "文件类型不支持";
}
大文件分片上传
对于大文件，可采用分片上传策略：前端将文件分割为多个小块，分别上传后由服务器合并,需实现分片上传接口和合并接口：
@PostMapping("/chunk")
public String uploadChunk(@RequestParam("file") MultipartFile chunk,
@RequestParam("chunkNumber") int chunkNumber,
@RequestParam("identifier") String identifier) {
// 保存分片文件，以identifier和chunkNumber命名
String chunkPath = "D:/chunks/" + identifier + "_" + chunkNumber;
file.transferTo(new File(chunkPath));
return "分片上传成功";
}
@PostMapping("/merge")
public String mergeChunks(@RequestParam("identifier") String identifier,
@RequestParam("fileName") String fileName,
@RequestParam("totalChunks") int totalChunks) {
// 按顺序合并所有分片文件
Path mergedFile = Paths.get("D:/uploads", fileName);
try (OutputStream os = Files.newOutputStream(mergedFile)) {
for (int i = 0; i < totalChunks; i++) {
Path chunkPath = Paths.get("D:/chunks", identifier + "_" + i);
Files.copy(chunkPath, os, StandardCopyOption.REPLACE_EXISTING);
Files.delete(chunkPath); // 删除分片文件
}
}
return "文件合并成功";
}
异常处理与日志记录
文件上传过程中可能抛出IOException、SizeLimitExceededException等异常,需通过全局异常处理器统一处理：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MaxUploadSizeExceededException.class)
public String handleMaxSizeException(MaxUploadSizeExceededException e) {
return "文件大小超过限制";
}
@ExceptionHandler(IOException.class)
public String handleIOException(IOException e) {
return "文件读写异常：" + e.getMessage();
}
}
使用日志框架（如SLF4J）记录上传过程中的关键信息,便于排查问题：
logger.info("文件上传开始：{}", file.getOriginalFilename());
logger.info("文件大小：{} KB", file.getSize() / 1024);
logger.info("文件保存路径：{}", dest.getAbsolutePath());
Java获取上传文件的方法多样，从原生Servlet的getPart()到Spring Boot的MultipartFile，可根据项目需求选择合适的技术方案，无论采用哪种方式，都需要关注文件名安全、类型校验、异常处理等细节，确保上传功能的安全性和稳定性，对于大文件场景，分片上传是提升用户体验的有效手段，值得在实际开发中应用，通过合理的技术选型和优化措施,可以构建出健壮的文件上传功能。
