第13章 文件上传
第 13 节 / 共 17 节
课程:前后端穿透
上传是前后端协作里最容易出安全问题的地方:文件太大、类型不对、文件名带路径、上传后能被直接执行。这一章把整条链路走一遍。
13.1 表单与 multipart
文件不能用 JSON 传。浏览器要用 multipart/form-data,每个文件是一个 part。
<form action="/api/upload" method="post" enctype="multipart/form-data">
<input type="file" name="file" accept=".html,.zip,.png,.jpg" />
<button type="submit">上传</button>
</form>
const fd = new FormData()
fd.append('file', file)
fd.append('quizId', '9002')
await axios.post('/api/fileUpload', fd, {
headers: { 'Content-Type': 'multipart/form-data' }
})
13.2 后端接收
@PostMapping("/upload")
public Result<String> upload(@RequestParam("file") MultipartFile file,
@RequestParam String quizId) throws IOException {
if (file.isEmpty()) return Result.fail("文件为空");
String name = storage.save(file, quizId);
return Result.ok(name);
}
MultipartFile 由 Spring 自动注入。要限制大小,在配置里设,不要只靠前端:
spring:
servlet:
multipart:
max-file-size: 20MB
max-request-size: 25MB
13.3 保存到哪
不要保存在项目目录里,否则重新部署就丢了。用独立目录,例如 /data/upload,再通过 Nginx 或静态映射暴露。
@Component
public class LocalStorage {
private final Path root = Paths.get("/data/upload");
public String save(MultipartFile file, String quizId) throws IOException {
String original = StringUtils.cleanPath(file.getOriginalFilename());
String ext = original.contains(".") ? original.substring(original.lastIndexOf(".")) : "";
String name = quizId + "_" + UUID.randomUUID() + ext;
Path target = root.resolve(name).normalize();
if (!target.startsWith(root)) throw new IOException("非法路径");
Files.createDirectories(root);
file.transferTo(target);
return name;
}
}
normalize() + startsWith(root) 是防目录穿越的关键。用户传 ../../etc/passwd 时,必须拒绝。
13.4 类型与内容校验
只看扩展名不够,攻击者可以把 jsp 改成 png。至少要同时检查:扩展名、Content-Type、文件头(magic number)。
Set<String> allow = Set.of("png", "jpg", "jpeg", "gif", "pdf", "zip", "html");
String ext = ...toLowerCase();
if (!allow.contains(ext)) return Result.fail("不支持的文件类型");
上传目录不要给执行权限。Nginx 只当静态文件读,不要把它配成 CGI/PHP 执行目录。
13.5 上传后立刻批改
很多作业系统有一个坑:第一次上传只保存文件,没有生成作答记录,所以不批改。正确顺序是“先保存文件,再用文件名作为答案提交一次”。
const up = await uploadAnswerFile(file, quizId, username, type)
await submitAnswer({ quizId, answer: up.fileName })
// 服务端这次才会创建/更新作答并批改
如果业务要求“上传即完成”,后端应该在保存文件后主动调用批改服务,而不是等前端再发一次请求。
13.6 下载与权限
文件不是放到公开目录就完了。作业、证件、合同这类文件必须鉴权:只有本人或管理员能下载。
@GetMapping("/download/{id}")
public ResponseEntity<Resource> download(@PathVariable Long id, HttpSession session) {
UploadFile f = service.get(id);
if (!f.getOwnerId().equals(session.getAttribute("userId"))) {
throw new BizException("403", "无权下载");
}
Resource r = new FileSystemResource(f.getPath());
return ResponseEntity.ok()
.header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=" + f.getName())
.body(r);
}
13.7 大文件与对象存储
文件多了以后,本地磁盘会成为瓶颈:备份、扩容、多机共享都麻烦。可以换成 OSS/S3,后端只存 URL 或 key。
| 方案 | 适合 | 注意 |
|---|---|---|
| 本地磁盘 | 小规模、单机 | 备份、权限、磁盘容量 |
| 对象存储 | 多机、大文件、CDN | 密钥管理、防盗链、生命周期 |
| 数据库 BLOB | 极小文件、强一致 | 不要存大文件,备份会爆炸 |
13.8 本章练习
- 实现一个上传接口,限制 20MB,只允许 png/jpg/pdf。
- 文件名用 UUID 重命名,验证
../路径会被拒绝。 - 上传后返回可访问 URL,并在前端显示预览。
下一章进入部署:Nginx 反向代理、HTTPS、SPA fallback、systemd。
《前后端穿透》课程目录
从浏览器里的一次点击出发,把 Vue 3 前端、Spring Boot 后端、MySQL 与 Nginx 串成一条完整链路