<think>我们正在处理一个关于
SpringBoot文件上传与下载的请求。用户要求一个示例教程。根据引用内容，我们知道
SpringBoot通过自动配置和简洁的API简化了
文件上传和下载。其中，引用[1]提到使用
SpringBoot可以轻松实现，引用[3]提到需要引入ApacheCommonsFileUpload组件依赖，但注意
SpringBoot默认使用的是StandardServlet
MultipartResolver（引用[4]），同
时也可以替换为Commons
MultipartResolver。我们需要构建一个简单的示例教程，包括：1
.环境准备（创建
SpringBoot项目，添加依赖）2
.文件上传的控制器和前端表单3
.文件下载的控制器4
.配置
文件上传大小限制等注意：引用[2]提供了一个示例下载链接，但我们不需要直接使用，而是根据引用内容编写。步骤：1
.创建
SpringBoot项目，添加
web依赖。在pom
.xml中，我们通常只需要spring-boot-starter-
web。但引用[3]提到需要ApacheCommonsFileUpload，实际上在
SpringBoot中，我们通常使用spring-boot-starter-
web已经集成的
文件上传功能，它依赖于ApacheCommonsFileUpload。但注意，从
SpringBoot1
.x到2
.x，
文件上传的处理方式有所变化。在
SpringBoot2
.x中，默认使用StandardServlet
MultipartResolver，它不需要额外的依赖（除了spring-boot-starter-
web）。2
.配置
文件上传属性（可选），例如最大
文件大小。3
.编写
上传控制器：-处理单个
文件上传-处理多个
文件上传4
.编写下载控制器。5
.编写简单的HTML表单用于测试。6
.注意：引用[4]提到可以替换为Commons
MultipartResolver，但我们这里使用默认的StandardServlet
MultipartResolver。根据以上步骤，我们开始编写示例代码。注意：由于我们是在文本中提供示例，因此只给出关键代码。首先，创建一个
SpringBoot项目，pom
.xml中只需要：<dependencies><dependency><groupId>
org.springframework.boot</groupId><artifactId>spring-boot-starter-
web</artifactId></dependency></dependencies>然后，在application
.properties中配置
文件上传大小限制（可选）：#单个
文件最大spring
.servlet
.multipart.max-file-size=10MB#总请求最大（多个
文件）spring
.servlet
.multipart.max-
request-size=20MB注意：在
SpringBoot2
.x中，配置属性为spring
.servlet
.multipart，而在1
.x中是spring
.http
.multipart。接下来，编写一个
文件上传控制器：</think>### Spring Boot
文件上传与下载教程
#### 一、环境准备
1
. **创建项目**
使用 Spring Initializr 创建项目，添加依赖：
```xml
<dependency>
<groupId>
org.springframework.boot</groupId>
<artifactId>spring-boot-starter-
web</artifactId>
</dependency>
```
2
. **配置
文件上传限制**
在 `application
.properties` 中配置：
```properties
# 单个
文件最大 10MB
spring
.servlet
.multipart.max-file-size=10MB
# 请求总大小最大 20MB
spring
.servlet
.multipart.max-
request-size=20MB
```
#### 二、
文件上传实现
1
. **创建控制器**
```java
@RestController
public class FileController {
// 指定存储
路径（示例：Windows系统）
private final String UPLOAD_DIR = "C
:/uploads/";
@PostMapping("/upload")
public ResponseEntity<String> uploadFile(@
RequestParam("file")
MultipartFile file) {
try {
// 创建目录（如果不存在）
Path path = Paths
.get(UPLOAD_DIR);
if (!Files
.exists(path)) {
Files
.createDirectories(path);
}
// 保存
文件
String fileName = file
.getOriginalFilename();
Files
.copy(file
.getInputStream(), path
.resolve(fileName));
return ResponseEntity
.ok("
上传成功
: " + fileName);
} catch (Exception e) {
return ResponseEntity
.status(500)
.body("
上传失败
: " + e
.getMessage());
}
}
}
```
2
. **前端表单示例**
```html
<form method="POST" action="/upload" enctype="
multipart/form-data">
<input type="file" name="file" />
<button type="submit">
上传</button>
</form>
```
#### 三、
文件下载实现
1
. **下载控制器**
```java
@GetMapping("/download/{filename
:.+}")
public ResponseEntity<Resource> downloadFile(@PathVariable String filename) {
try {
Path filePath = Paths
.get(UPLOAD_DIR)
.resolve(filename);
Resource resource = new UrlResource(filePath
.toUri());
return ResponseEntity
.ok()
.header(HttpHeaders
.CONTENT_DISPOSITION,
"attachment; filename=\"" + filename + "\"")
.body(resource);
} catch (Exception e) {
return ResponseEntity
.status(404)
.build();
}
}
```
#### 四、高级优化方案
1
. **
文件重命名**（防重复）
```java
String newFileName = UUID
.randomUUID() + "_" + file
.getOriginalFilename();
```
2
. **
文件类型验证**
```java
if (!file
.getContentType()
.startsWith("image/")) {
return ResponseEntity
.bad
Request()
.body("仅支持图片
文件");
}
```
3
. **异步处理**
使用 `@Async` 注解实现异步
上传[^4]：
```java
@Async
public void saveFileAsync(
MultipartFile file) {
... }
```
#### 五、完整执行流程
```mermaid
graph TD
A[用户提交表单] --> B(控制器接收
MultipartFile)
B --> C{验证
文件有效性}
C -->|有效| D[保存到指定目录]
C -->|
无效| E[返回错误信息]
D --> F[返回成功响应]
G[下载请求] --> H[根据
文件名查找
文件]
H -->|存在| I[返回Resource资源]
H -->|不存在| J[返回404错误]
```
> **注意事项**
> 1
. 生产环境中建议使用云存储（如AWS S3、阿里云OSS）替代
本地存储
> 2
. 大
文件上传需分片处理（如使用
WebUploader）
> 3
. 敏感
文件需添加权限校验[^1]
本文详细解析了在使用SpringBoot结合Zuul网关进行文件上传时遇到的常见错误，包括错误信息的解读、错误产生的原因及四种有效的解决方案，如重启服务、检查依赖引入、配置multipart组件等。
扫一扫
5597
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
