第13章 文件上传

第 13 节 / 共 17 节 课程:前后端穿透

上传是前后端协作里最容易出安全问题的地方:文件太大、类型不对、文件名带路径、上传后能被直接执行。这一章把整条链路走一遍。

文件上传:三份数据,三个落点浏览器FormData + fileControllerMultipartFile磁盘 / OSSuploads/ 目录multiparttransferTo数据库保存文件元数据文件名 / URL / 大小静态映射/uploads/**回读只把“文件内容”放磁盘,把“文件信息”放数据库;不要把二进制塞进 MySQL。
图 13-1 上传文件、元数据与静态访问

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 本章练习

  1. 实现一个上传接口,限制 20MB,只允许 png/jpg/pdf。
  2. 文件名用 UUID 重命名,验证 ../ 路径会被拒绝。
  3. 上传后返回可访问 URL,并在前端显示预览。

下一章进入部署:Nginx 反向代理、HTTPS、SPA fallback、systemd。