SpringBoot中6个文件上传下载工具，干货满满，不容错过
你说，文件上传和下载这玩意儿是不是再普通不过了？是的，大家都知道，但一旦遇到需要实现的时候，你才知道，做得好就能轻松搞定，做得不好，项目能崩。特别是在SpringBoot这种大框架下，可能你平时觉得简单的功能，稍不留神，就可能给你的服务带来不必要的麻烦——文件丢失、上传卡顿、下载超时，这些不管发生在什么时候都很“尴尬”。
这篇文章我给大家掏心窝子的来点干货，列出6个我自己实战中最常用的文件上传下载工具。相信大家看完之后，能快速实现高效稳定的文件上传下载功能，从此不再迷茫！废话少说，咱直接上干货，看看每个工具如何完美解决实际问题，干得漂亮，稳得住！
1、基础文件上传：Multipart + Spring Boot Controller
适用场景：
想简单上传个文件，啥复杂需求没有，就是普通的表单提交文件或者接口上传，直接用Spring Boot自带的Multipart处理就行，省时省力，稳当。
代码示例：
@RestController
public class FileUploadController {
// 这里用的就是Spring Boot默认的文件上传方式
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file) throws IOException {
// 获取文件名
String fileName = file.getOriginalFilename();
// 你可以自己定一个路径存储上传文件，这里我就存到了本地
String savePath = "D:/uploads/" + fileName;
// 直接存到本地，不做其他处理
File dest = new File(savePath);
file.transferTo(dest); // Spring封装的文件流保存操作
return "上传成功！保存路径：" + savePath;
}
}
解析：
这段代码超级简单，基本上就是调用Spring Boot内置的Multipart文件上传处理。可以直接处理小文件，写入指定路径，不复杂也没啥花里胡哨的配置。就是基础功能实现，不要求啥复杂控制，想要快速搞定文件上传的，直接用这招。可以说是“简单粗暴，直接搞定”。
2、文件下载：InputStream + OutputStream 操作
适用场景：
你想在服务端提供文件下载接口，控制文件下载的流量、格式，甚至是动态生成的文件下载，必须要自己动手处理好输入流和输出流。Spring Boot的默认配置一般只能应付简单场景，复杂的就得自己撸流操作了。
代码示例：
@GetMapping("/download")
public void downloadFile(HttpServletResponse response) throws IOException {
// 你想下载的文件路径
String filePath = "D:/uploads/sample.txt";
File file = new File(filePath);
if (!file.exists()) {
response.setStatus(HttpServletResponse.SC_NOT_FOUND); // 如果文件没找到，返回404
return;
}
// 设置下载响应的头信息
response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", "attachment; filename=" + file.getName());
// 读取文件内容，写入到响应的OutputStream中
InputStream inputStream = new FileInputStream(file);
OutputStream outputStream = response.getOutputStream();
byte[] buffer = new byte[1024];
int length;
while ((length = inputStream.read(buffer)) != -1) {
outputStream.write(buffer, 0, length); // 将文件流写入响应中
}
inputStream.close();
outputStream.close();
}
解析：
这段代码就是自己控制文件流的读取和写入。下载文件时，不光是返回文件路径，而是通过InputStream读取文件内容，然后通过OutputStream把内容写入HTTP响应流。这种方式能精确控制下载过程，适用于大文件下载、限制下载速度等场景。
3、文件上传 + OSS：Spring Boot 集成阿里云OSS
适用场景：
这方法适合那些需要把文件上传到云端的场景。阿里云的OSS，简单、稳定、便宜，如果项目需要大规模文件存储和访问，别再想本地存储了，赶紧搞定OSS吧。你也可以换成七牛、腾讯云，反正操作类似。
代码示例：
首先得先配置阿里云OSS的SDK依赖：
<!-- 阿里云OSS SDK依赖 -->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.10.2</version>
</dependency>
然后，在Spring Boot中配置OSS上传：
@RestController
public class OssFileUploadController {
@Value("${aliyun.oss.endpoint}")
private String endpoint;
@Value("${aliyun.oss.access-key-id}")
private String accessKeyId;
@Value("${aliyun.oss.access-key-secret}")
private String accessKeySecret;
@Value("${aliyun.oss.bucket-name}")
private String bucketName;
@PostMapping("/uploadToOss")
public String uploadFileToOss(@RequestParam("file") MultipartFile file) {
try {
// 创建OSSClient实例
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
// 获取文件名
String fileName = file.getOriginalFilename();
// 上传文件
InputStream inputStream = file.getInputStream();
ossClient.putObject(bucketName, fileName, inputStream);
// 关闭OSS客户端
ossClient.shutdown();
return "文件上传至OSS成功！文件名：" + fileName;
} catch (Exception e) {
e.printStackTrace();
return "上传失败：" + e.getMessage();
}
}
}
解析：
这段代码就是把文件上传到阿里云OSS的实现。首先，通过配置文件获取阿里云的accessKeyId、accessKeySecret等信息，然后用OSSClient进行上传。你可以在阿里云控制台创建一个OSS Bucket，存放你的文件，上传后它会返回一个云端地址，你可以直接访问这个文件。
这招适合需要将文件长期存储并且能快速访问的情况。别再想着存自己服务器了，使用OSS能有效减轻服务器负担，节省成本，而且OSS做得特别稳。
4、文件下载 + OSS：从OSS直接下载文件
适用场景：
假如你前面已经上传文件到OSS，后面可能就得让用户下载。你可以直接让文件保存在云端，用户从云端下载，避免了服务器负担。还是用阿里云OSS为例，下载就能给你整得超级简单。
代码示例：
@GetMapping("/downloadFromOss")
public void downloadFileFromOss(@RequestParam("fileName") String fileName, HttpServletResponse response) {
try {
// 创建OSSClient实例
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
// 获取文件内容
OSSObject ossObject = ossClient.getObject(bucketName, fileName);
InputStream inputStream = ossObject.getObjectContent();
// 设置响应头，告诉浏览器这是个附件文件
response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", "attachment;filename=" + fileName);
// 输出文件内容到响应流
OutputStream outputStream = response.getOutputStream();
byte[] buffer = new byte[1024];
int length;
while ((length = inputStream.read(buffer)) != -1) {
outputStream.write(buffer, 0, length);
}
// 关闭资源
inputStream.close();
outputStream.close();
ossClient.shutdown();
} catch (IOException e) {
e.printStackTrace();
}
}
解析：
这段代码就很简单，基本就是获取OSS中的文件内容，通过输入流getObjectContent()方法获取文件，然后通过输出流直接返回给前端。这里的关键点就是OSS的OSSClient，你不需要担心文件过大啥的，因为阿里云给你处理得非常好。
这方式特别适合文件需要长期存储并且频繁下载的情况，你不需要自己管理存储空间，直接把文件交给OSS，它会自动帮你管理和备份。
5、文件上传 + MinIO：分布式存储方案
适用场景：
有的项目，你需要的不是阿里云那种商用方案，而是可以自己控制、灵活配置的分布式存储。这个时候，MinIO就能派上用场。它兼容S3接口，支持大文件上传、分片上传，可以搭建自己私有的云存储。简直就像是你自己搭了一个OSS，在自己家服务器上跑，既节省了成本，又能保证数据的安全性。
代码示例：
首先，你得添加MinIO的依赖：
<!-- MinIO依赖 -->
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.0.3</version>
</dependency>
然后，你得在Spring Boot中配置MinIO：
@RestController
public class MinioFileUploadController {
@Value("${minio.url}")
private String minioUrl;
@Value("${minio.access-key}")
private String accessKey;
@Value("${minio.secret-key}")
private String secretKey;
@Value("${minio.bucket-name}")
private String bucketName;
@PostMapping("/uploadToMinio")
public String uploadToMinio(@RequestParam("file") MultipartFile file) {
try {
// 创建MinIO客户端
MinioClient minioClient = MinioClient.builder()
.endpoint(minioUrl)
.credentials(accessKey, secretKey)
.build();
// 获取文件名
String fileName = file.getOriginalFilename();
// 上传文件到指定bucket
minioClient.putObject(
PutObjectArgs.builder()
.bucket(bucketName)
.object(fileName)
.stream(file.getInputStream(), file.getSize(), -1)
.contentType(file.getContentType())
.build()
);
return "文件上传到MinIO成功，文件名：" + fileName;
} catch (Exception e) {
e.printStackTrace();
return "上传失败：" + e.getMessage();
}
}
}
解析：
MinIO的操作方法与阿里云OSS类似，但它是基于S3协议的。通过配置MinIO的MinioClient，你可以非常方便地将文件上传到自己的分布式存储环境中。MinIO的优势在于：不仅能兼容很多现有的S3接口，还能做到超高的并发能力，支持对象分片上传，适合大规模存储需求。
这类方案适用于需要自己搭建存储环境的情况，像是公司内部需要自己管理的数据，或者是成本考虑，不能依赖第三方云存储商的场景。
6、高并发文件上传：Spring Boot + Nginx + 高效文件上传（分片上传）
适用场景：
这招主要是处理高并发文件上传的场景，尤其是需要处理大文件上传，或者多个文件同时上传时。你不能简单地把所有文件都压缩在一个请求中，这样容易超时、卡顿，影响用户体验。分片上传就能把大文件分成若干小块，逐步上传，上传成功后再合并回原文件。这样就能避免上传超时的问题，提高文件上传效率。
代码示例：
首先，前端用JavaScript来分片上传文件，每次只上传文件的一部分：
// 前端文件分片上传示例
const uploadFile = (file) => {
const chunkSize = 1024 * 1024; // 每块大小为1MB
let start = 0;
let end = chunkSize;
const totalChunks = Math.ceil(file.size / chunkSize);
const uploadNextChunk = () => {
const formData = new FormData();
formData.append("file", file.slice(start, end)); // 取文件的一部分
fetch('/uploadChunk', {
method: 'POST',
body: formData
}).then(response => {
if (response.ok) {
start = end;
end = start + chunkSize;
if (start < file.size) {
uploadNextChunk(); // 递归上传下一块
} else {
alert("文件上传完成！");
}
} else {
alert("上传失败！");
}
});
};
uploadNextChunk(); // 开始上传
};
接着，Spring Boot的后端处理上传的每个分片：
@RestController
public class FileUploadController {
@PostMapping("/uploadChunk")
public String uploadChunk(@RequestParam("file") MultipartFile file) {
try {
// 获取上传的分片文件名，分片的索引可以在前端传递
String fileName = "bigfile_part_" + System.currentTimeMillis();
String savePath = "D:/uploads/" + fileName;
// 存储文件分片
File dest = new File(savePath);
file.transferTo(dest);
return "分片上传成功：" + fileName;
} catch (IOException e) {
e.printStackTrace();
return "上传失败：" + e.getMessage();
}
}
}
解析：
分片上传的关键是前端和后端的配合，前端将文件分割成小块，然后通过多次请求上传到后端，后端接收到每个分片后保存文件。每个分片上传成功后，前端继续上传下一个分片，直到所有分片上传完成。
在高并发和大文件上传时，这种方式能大大提升效率，避免超时和卡顿。你可以通过前端的fetch来控制每个分片的上传，后端接收到文件后，将分片保存到本地，之后再合并为完整文件。
总结
到这里，咱整了6种不同的文件上传下载工具，覆盖了从基础的本地存储到云端存储，再到高并发、大文件上传的场景。你要是做一个简单的上传功能，前面介绍的Spring Boot自带Multipart和OSS就能轻松搞定；如果你要做复杂的存储需求，MinIO可以为你提供分布式存储解决方案，给你带来高效且可控的存储体验。
如果你做的是一个有较高并发或者大文件上传需求的系统，那就该考虑分片上传了，Nginx做反向代理，配合Spring Boot的高效上传策略，完美解决并发问题。
无论你在做什么类型的项目，文件上传和下载这一块，绝对是关键部分，得处理得稳妥，这样才能避免后期问题的爆发。希望这篇文章给你们带来一些实际的帮助，代码我都给你们抛出来了，剩下的就是亲自体验、亲自修改调试了。你能做得比我更好，我敢打赌，这绝对是你技术之路上的一个小进步。