Java文件上传核心是处理multipart/form-data请求，Spring Boot用MultipartFile快速实现，原生Servlet需Apache Commons FileUpload；须重命名文件、校验类型、限大小、隔离上传目录。
Java中实现简单文件上传，核心是处理HTTP表单提交的multipart/form-data请求，后端用Servlet或Spring Boot接收并保存文件。关键不在“写多少代码”，而在于理解数据怎么来、怎么解析、怎么安全落地。
使用Spring Boot快速实现（推荐初学者）
Spring Boot内置了对文件上传的友好支持，只需少量配置和代码：
- 确保
application.properties中设置了上传限制（可选但建议）：spring.servlet.multipart.max-file-size=10MBspring.servlet.multipart.max-request-size=10MB - 编写一个接收文件的Controller方法：
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file, Model model) {
if (!file.isEmpty()) {
try {
// 保存到项目同级的uploads目录（注意路径权限）
String uploadDir = "../uploads/";
Files.createDirectories(Paths.get(uploadDir));
Path path = Paths.get(uploadDir + file.getOriginalFilename());
Files.write(path, file.getBytes());
model.addAttribute("msg", "上传成功：" + file.getOriginalFilename());
} catch (IOException e) {
model.addAttribute("msg", "上传失败：" + e.getMessage());
}
} else {
model.addAttribute("msg", "请选择文件");
}
return "result"; // 返回页面名
}
原生Servlet方式（理解底层原理）
如果不依赖Spring，可用标准Servlet + Apache Commons FileUpload库（需引入commons-fileupload和commons-io）：
- HTML表单必须设
enctype="multipart/form-data"且method为POST - 在Servlet中判断是否为多部分请求：
ServletFileUpload.isMultipartContent(request) - 用
ServletFileUpload解析请求，遍历FileItem获取普通字段和文件字段 - 对
isFormField()==false的项调用item.write(file)保存
几个必须注意的安全细节
文件上传看似简单，但疏忽易引发风险：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
立即学习“Java免费学习笔记（深入）”；
-
不要直接用客户端传来的原始文件名——可能含
../路径穿越或特殊字符，建议用UUID重命名 -
校验文件类型不能只看后缀——应读取文件头（magic number）或使用
Tika等工具检测真实MIME类型 - 限制大小和数量——避免恶意大文件耗尽磁盘或内存
-
上传目录不要放在Web根路径下——防止用户通过URL直接访问执行脚本（如
.jsp、.php）
前端配合要点
后端再稳，前端没配对也白搭：
- 表单
<form enctype="multipart/form-data" method="post"> - 文件输入框写法：
<input type="file" name="file">（name值要和后端@RequestParam一致） - 如需多文件，加
multiple属性，并后端用MultipartFile[]或List<MultipartFile>接收 - 可加
accept=".pdf,.jpg,.png"做浏览器端初步过滤（仅提示，不可靠）
基本上就这些。不复杂但容易忽略细节，跑通一次后，再加进度条、分片上传、云存储对接，就是顺理成章的事了。
