首先使用Spring Boot结合MultipartFile实现文件上传，前端需设置enctype="multipart/form-data"，后端通过@RequestParam接收并保存文件至指定目录，同时可记录元数据到数据库；接着实现文件下载功能，通过@GetMapping返回文件流，并设置Content-Disposition响应头触发浏览器下载，确保文件路径安全且支持中文文件名；最后提出安全与优化建议，包括限制文件类型与大小、重命名防冲突、保护上传目录、权限校验、数据库记录元数据以及支持断点续传，确保系统安全稳定。
在Java项目中实现文件上传下载功能，是很多管理系统（如OA、CRM、ERP）中的常见需求。这类功能通常涉及前端页面表单提交、后端接收处理文件、存储到服务器或数据库、生成访问路径以及提供安全的下载接口。下面从技术选型、关键代码和注意事项三个方面说明如何开发文件管理功能。
文件上传实现
文件上传依赖于HTTP的multipart/form-data请求格式。Spring Boot项目中可以使用Spring MVC提供的MultipartFile来简化处理。
1. 前端表单要求：必须设置enctype="multipart/form-data"，否则文件无法正确传输。
2. 后端接收示例：
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
@PostMapping("/upload")
public ResponseEntity
if (file.isEmpty()) {
return ResponseEntity.badRequest().body("文件为空");
}
String uploadDir = "/uploads/" + userId;
File dir = new File(uploadDir);
if (!dir.exists()) dir.mkdirs();
String fileName = System.currentTimeMillis() + "_" + file.getOriginalFilename();
Path path = Paths.get(uploadDir, fileName);
try {
Files.copy(file.getInputStream(), path, StandardCopyOption.REPLACE_EXISTING);
// 可记录文件信息到数据库（如文件名、路径、大小、上传时间等）
return ResponseEntity.ok("上传成功: " + fileName);
} catch (IOException e) {
return ResponseEntity.status(500).body("上传失败");
}
}
文件下载实现
下载功能需要返回文件流，并设置正确的响应头，让浏览器触发下载行为。
1. 根据文件名或ID查找文件路径
2. 设置响应头Content-Disposition
3. 将文件写入输出流
@GetMapping("/download/{filename}")
public void downloadFile(@PathVariable String filename, HttpServletRequest request, HttpServletResponse response) throws IOException {
String filePath = "/uploads/user123/" + filename;
Path path = Paths.get(filePath);
if (!Files.exists(path)) {
response.setStatus(HttpServletResponse.SC_NOT_FOUND);
return;
}
String mimeType = Files.probeContentType(path);
if (mimeType == null) mimeType = "application/octet-stream";
response.setContentType(mimeType);
response.setContentLength((int) Files.size(path));
response.setHeader("Content-Disposition", "attachment; filename=\"" + URLEncoder.encode(filename, "UTF-8") + "\"");
Files.copy(path, response.getOutputStream());
response.flushBuffer();
}
安全与优化建议
实际项目中不能只做基础上传下载，还需考虑以下几点：
- 限制文件类型（如只允许.jpg,.pdf,.docx），防止恶意脚本上传
- 控制文件大小（通过application.yml配置spring.servlet.multipart.max-file-size）
- 文件名防冲突：使用UUID或时间戳重命名
- 敏感路径保护：上传目录不在Web根目录下，避免直接URL访问
- 权限校验：下载前验证用户是否有权访问该文件
- 数据库记录：保存文件元数据便于管理与审计
- 支持断点续传（需实现Range请求处理）适用于大文件场景
基本上就这些。Java实现文件上传下载不复杂，但细节决定安全性与稳定性。结合Spring Boot和NIO能快速搭建可靠的文件服务模块。
