当前位置：首页 > news >正文

2023.11.23 云服务器实现 Spring Boot 项目文件上传并访问

news 2025/7/30 12:14:25

环境介绍

云服务器：京东云
云服务器系统： CentOS 7.9
JDK 版本：1.8
Spring Boot 版本：2.7.17

具体步骤

步骤一

首先我们得先创建一个 Spring Boot 项目

创建如下目录结构

关于如何创建一个 Spring Boot 项目请点击下方链接详细了解

创建 Spring Boot 项目详细步骤

步骤二

使用 Xshell 操作你的云服务器
此时我们将在云服务器的 root 目录下设置一个 upload 目录，用来保存上传的文件

步骤三

创建文件上传接口
在 Spring Boot 项目中，需要创建一个控制器（Controller）来处理文件上传的请求
此处可以使用 MultipartFile 对象来接收上传的文件
package com.example.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.util.ClassUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestPart;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;
import java.util.UUID;@Controller
@ResponseBody
@RequestMapping("/file")
public class FileController {@RequestMapping("/only-file")public String upFile(@RequestPart("myfile")MultipartFile file) throws IOException {
//        获取上传文件的原始文件名，并从中提取出文件的后缀名String fileName = file.getOriginalFilename().substring(file.getOriginalFilename().lastIndexOf("."));
//        生产一个文件路径，该路径位于 /root/upload 目录下，并且文件名是一个随机的 UUID 加上文件的后缀名String filePath = "/root/upload" + "/" + UUID.randomUUID() + fileName;file.transferTo(new File(filePath));return filePath + "upload success!";}
}
此处我们在 controller 文件夹中创建一个 FileController 类用来处理文件上传的请求

重点：

此处我们文件要存储的路径是以云服务器中根目录为基准来写的
我们第二步在云服务器中的 root 目录下创建了一个 upload 目录用来存放上传文件
所以此时的上传文件理应存放在路径 "/root/upload" 目录下

步骤四

因为我们的Spring Boot 项目是作为一个独立的 jar 包运行的
所以我们需要在 Spring Boot 项目中进行一些配置，以便能够访问到存储在云服务器上的文件
因此我们需要在 Spring boot 项目中添加一个配置类，用于将文件存储路径映射为静态资源路径
package com.example.demo.configuration;import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;@Configuration
public class WebMvcConfig implements WebMvcConfigurer {@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/uploads/**").addResourceLocations("file:" + "/root/upload/");}
}
此处我们在 configuration 文件夹中创建一个 WebMvcConfig 类用来处理文件上传的请求
在这个配置类中，我们在 addResourceHandlers 方法中将我们存放上传文件的路径映射为 " /uploads/** " 的静态资源路径
最后我们便可以通过在浏览器中输入 http://服务器公网IP:8080/uploads/filename 来访问上传的文件

步骤五

我们将写好的 Spring Boot 项目打包并将打包好的 jar 包复制存储到云服务器 root 目录下

打包完成后其所生成的 jar 包就在 target 目录下

在文件资源管理器中找到该 jar 包的位置

步骤六

我们直接在云服务器启动我们 Spring Boot 项目
使用 " java -jar （jar 包名）"
此处我们的 jar 包名为 demo-0.0.1-SNAPSHOT.jar
所以使用 java -jar demo-0.0.1-SNAPSHOT.jar 命令来启动 Spring boot 项目

步骤七

使用 Postman 构造上传文件的 form 表单请求

想要了解和使用 Postman 请点击下方链接

Postman 安装和使用

请翻阅至该链接的末尾

步骤八

在 Postman 下方查看上传文件的新文件名

直接在浏览器输入对应的 URL 地址，来访问你上传的文件