如何在SpringBoot 优雅地实现文件的上传和下载

关注

原创最新推荐文章于 2026-02-06 01:06:04 发布 541 阅读 AI 写同款· GEO 优化 ›

SpringBoot文件上传下载详解下载的原理其实就是根据你要下载的文件名看看我们的磁盘中有没有这个文件对比一下文件名字，如果有就下载，没有就下载失败。首先理解一下文件上传的原理，其实就是把传过来的文件存到我们的磁盘上，既然要存磁盘所以我们得指定文件存储的路径等。这篇文章记录我自己的学习过程的SpringBoot的文件上传下载的代码的理解。代码写完了介绍问了，接下来测试一下看看我们的接口能不能用。可以看到上传成功了，也生成了文件名。首先先把代码写上，然后逐一理解。我的路径值得就是这个。阅读详情

1.效果演示

2.技术栈

maven
springboot
mybatis-plus
mysql
thymeleaf
bootstrap

3.数据库表

CREATE TABLE `t_upload_file` ( `id` bigint(11) NOT NULL AUTO_INCREMENT, `old_name` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL, `new_Name` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL, `url_path` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL, `size` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL, `file_type` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL, `created_date` datetime DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB AUTO_INCREMENT=40 DEFAULT CHARSET=utf8; 复制代码

4.创建 springboot 项目

5.引入依赖

这里我们主要引入以下依赖：

web
mybatis-plus
mysql 驱动
thymeleaf
commons-fileupload
lombok

commons-fileupload 是一个上传文件的组件，该组件封装了一些上传文件的方法。

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>  <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.4.0</version> </dependency>  <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>  <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency>  <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency>  <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency> 复制代码

6.修改配置文件

这里主要包含数据源、thymeleaf、mybatis-plus 三个模块的配置。

7.代码生成

这里使用 mybatis-plus 的代码生成工具自动生成 controller、entity、service、mapper，极大地提高代码开发效率。

记得添加以下依赖：

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-generator</artifactId> <version>3.5.1</version> </dependency> <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> </dependency> 复制代码

输入表名然后运行该程序：

8.前端

前端主要使用了 thymeleaf 和 bootstrap。Thymeleaf 是一种模板引擎技术，bootstrap 是 Twitter 推出的前端开发框架。

新建 index.html 文件，分别引入 bootstrap 的 css 和 Thymeleaf 的命名空间。

9.文件列表功能

后端：

查询列表数据，封装到 model 里面，然后跳转到列表页面。

前端：

列表页面使用 Thymeleaf 常用的标签：

10.文件上传

前端表单发起 post 请求，切记 enctype 格式是 multipart/form-data。

<form method="post" enctype="multipart/form-data" th:action="@{/file/upload}"> <input type="file" name="multipartFile"> <input type="submit" style="margin-top:20px" value="点击上传" class="btn btn-primary btn-sm"/> </form> 复制代码

后端用 MultipartFile 类型的对象接收文件，然后将文件拷贝到固定格式文件夹下：