绝对地址存数据库 上传访问 宝塔部署时的项目

# Spring Boot 文件上传与静态资源访问部署指南> 本 Skill 详细讲解 Spring Boot 项目如何实现文件上传、静态资源映射，以及在服务器上的部署配置。---## 一、架构概览```
┌─────────────────────────────────────────────────────────────────┐
│                        文件上传流程                              │
├─────────────────────────────────────────────────────────────────┤
│  客户端上传 ──► Controller ──► Upload工具类 ──► 外部目录存储      │
│                                      │                          │
│                                      ▼                          │
│                              返回访问URL                          │
└─────────────────────────────────────────────────────────────────┘┌─────────────────────────────────────────────────────────────────┐
│                        文件访问流程                              │
├─────────────────────────────────────────────────────────────────┤
│  HTTP请求 ──► WebConfig资源映射 ──► 外部目录读取 ──► 返回文件     │
│     │                                                           │
│     ▼                                                           │
│  /images/xxx.jpg ──► file:/uploadPath/images/xxx.jpg            │
└─────────────────────────────────────────────────────────────────┘
```---## 二、核心组件### 2.1 配置文件 (application.properties)```properties
# ========== 文件上传配置 ==========
# 单个文件最大大小
spring.http.multipart.maxFileSize=100Mb
# 总请求最大大小
spring.http.multipart.maxRequestSize=1000Mb# 文件存储路径（外部目录，独立于应用）
file.upload-path=/data/uploadPath# ========== 服务配置 ==========
server.port=8080
server.context-path=/sch_trade# ========== 视图配置（JSP） ==========
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
```**关键点**：
- `file.upload-path` 必须是**外部目录**，不能在项目内部
- 这样应用升级/重新部署时，上传的文件不会丢失---### 2.2 文件上传控制器 (ImgUploadController.java)```java
@Controller
@RequestMapping("/imgUpload")
public class ImgUploadController {@Value("${file.upload-path}")private String uploadPath;@RequestMapping(value = "/thumb", method = RequestMethod.POST)@ResponseBodypublic Object generateImage(@RequestParam("file") MultipartFile file,HttpServletRequest request) throws IOException {Map<String, Object> result = new HashMap<>();// 1. URI 访问路径（用于生成访问URL）String uriPath = "sch_trade/images";// 2. 物理存储路径String realUploadPath = uploadPath + File.separator + "images";// 3. 确保目录存在File dir = new File(realUploadPath);if (!dir.exists()) {dir.mkdirs();}// 4. 执行上传，返回相对路径String relativeUrl = Upload.uploadImage(file, realUploadPath, uriPath);// 5. 获取完整访问URL（兼容代理环境）String baseUrl = getBaseUrl(request);String finalUrl = baseUrl + "/" + relativeUrl;result.put("code", 0);result.put("url", finalUrl);return result;}/*** 获取真实访问域名（兼容 Nginx/负载均衡/反向代理）*/private String getBaseUrl(HttpServletRequest request) {// 优先从代理头获取String scheme = request.getHeader("X-Forwarded-Proto");if (scheme == null) {scheme = request.getScheme();}String host = request.getHeader("X-Forwarded-Host");if (host == null) {host = request.getHeader("Host");}if (host == null) {host = request.getServerName() + ":" + request.getServerPort();}// 处理默认端口（80/443 不显示端口号）if ((scheme.equals("http") && host.endsWith(":80")) ||(scheme.equals("https") && host.endsWith(":443"))) {host = host.replace(":80", "").replace(":443", "");}return scheme + "://" + host;}
}
```**核心逻辑**：
1. 从配置读取外部存储路径
2. 调用 `Upload.uploadImage()` 执行实际存储
3. 生成完整访问 URL（支持代理环境）---### 2.3 文件上传工具类 (Upload.java)```java
public class Upload {private static final SimpleDateFormat df = new SimpleDateFormat("yyyyMMddHHmmss");public static String uploadImage(MultipartFile file,String realUploadPath,String uriPath) throws IOException {// 1. 确保基础目录存在File baseDir = new File(realUploadPath);if (!baseDir.exists() && !baseDir.mkdirs()) {throw new IOException("无法创建目录: " + realUploadPath);}// 2. 按时间戳创建子目录（避免单目录文件过多）String date = df.format(new Date());File dateDir = new File(realUploadPath, date);if (!dateDir.exists() && !dateDir.mkdirs()) {throw new IOException("无法创建日期目录: " + dateDir.getAbsolutePath());}// 3. 保存文件String originalFilename = file.getOriginalFilename();File outputFile = new File(dateDir, originalFilename);try (InputStream in = file.getInputStream();OutputStream out = new FileOutputStream(outputFile)) {byte[] buffer = new byte[1024];int len;while ((len = in.read(buffer)) > 0) {out.write(buffer, 0, len);}}// 4. 返回相对访问路径// 例如: sch_trade/images/20260425151257/photo.jpgreturn uriPath + "/" + date + "/" + outputFile.getName();}
}
```**设计亮点**：
- 按时间戳分子目录存储，避免单目录文件过多影响性能
- 返回相对路径，由 Controller 拼接完整 URL---### 2.4 静态资源映射配置 (WebConfig.java)```java
@Configuration
public class WebConfig implements WebMvcConfigurer {@Value("${file.upload-path}")private String uploadPath;@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {// ========== 上传文件映射 ==========// URL: /images/**  -->  物理路径: file:/uploadPath/images/registry.addResourceHandler("/images/**").addResourceLocations("file:" + uploadPath + "/images/");// ========== 静态资源映射 ==========// URL: /static/**  -->  物理路径: file:/uploadPath/static/registry.addResourceHandler("/static/**").addResourceLocations("file:" + uploadPath + "/static/");}@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new LoginInterceptor()).addPathPatterns("/**")// 排除静态资源（无需登录即可访问）.excludePathPatterns("/static/**").excludePathPatterns("/images/**");  // 重点：上传的图片也要排除
    }
}
```**关键点**：
- `file:` 前缀表示映射到**文件系统路径**，不是 classpath
- 拦截器必须排除 `/images/**`，否则未登录用户看不到图片---## 三、路径映射关系```
┌────────────────────────────────────────────────────────────────────┐
│                         路径映射表                                  │
├──────────────────────┬─────────────────────────────────────────────┤
│      URL 访问路径     │              物理存储路径                    │
├──────────────────────┼─────────────────────────────────────────────┤
│ /sch_trade/images/** │ file:/data/uploadPath/images/**             │
├──────────────────────┼─────────────────────────────────────────────┤
│ /sch_trade/static/** │ file:/data/uploadPath/static/**             │
└──────────────────────┴─────────────────────────────────────────────┘示例：访问: http://server:8080/sch_trade/images/20260425/photo.jpg映射: /data/uploadPath/images/20260425/photo.jpg
```---## 四、服务器部署步骤### 4.1 环境准备```bash
# 安装 JDK 8+
yum install java-1.8.0-openjdk-devel# 安装 MySQL
yum install mysql-server
systemctl start mysqld# 创建上传目录
mkdir -p /data/uploadPath/images
mkdir -p /data/uploadPath/static
chmod -R 755 /data/uploadPath
```### 4.2 数据库初始化```bash
mysql -u root -p < sch_trade.sql
```### 4.3 配置修改创建生产环境配置 `application-prod.properties`：```properties
# 数据库配置
spring.datasource.dev.url=jdbc:mysql://localhost:3306/sch_trade?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
spring.datasource.dev.username=prod_user
spring.datasource.dev.password=secure_password# 文件上传路径（服务器路径）
file.upload-path=/data/uploadPath# 服务端口
server.port=8080
```### 4.4 打包部署```bash
# 打包（跳过测试）
mvn clean package -DskipTests# 运行
java -jar target/sch_trade-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod# 或后台运行
nohup java -jar sch_trade-0.0.1-SNAPSHOT.jar \--spring.profiles.active=prod \> /var/log/sch_trade.log 2>&1 &
```### 4.5 Nginx 反向代理（推荐）```nginx
server {listen 80;server_name example.com;location /sch_trade/ {proxy_pass http://127.0.0.1:8080/sch_trade/;proxy_set_header Host $host;proxy_set_header X-Forwarded-Proto $scheme;proxy_set_header X-Forwarded-Host $host;# 文件上传大小限制client_max_body_size 100M;}
}
```---## 五、常见问题排查### 问题1: 上传后图片无法访问**排查步骤**：
```bash
# 1. 检查文件是否存在
ls -la /data/uploadPath/images/# 2. 检查目录权限
ls -la /data/uploadPath/# 3. 检查应用日志
tail -f /var/log/sch_trade.log
```**常见原因**：
- 目录权限不足 → `chmod -R 755 /data/uploadPath`
- 路径配置错误 → 检查 `file.upload-path`
- 拦截器未排除 → 检查 `excludePathPatterns("/images/**")`### 问题2: 返回的URL是localhost**原因**: 未正确处理代理头**解决**: 确保 `getBaseUrl()` 方法正确读取 `X-Forwarded-Host` 和 `X-Forwarded-Proto`### 问题3: 文件上传失败**排查**：
```bash
# 检查临时目录权限
ls -la /tmp# 检查磁盘空间
df -h
```---## 六、最佳实践1. **文件外置存储** - 上传文件独立于应用，升级不丢失
2. **按时间分目录** - 避免单目录文件过多
3. **代理头处理** - 兼容 Nginx/负载均衡环境
4. **权限分离** - 上传目录与应用目录分离，便于权限管理
5. **日志记录** - 记录上传路径，便于问题排查---## 七、扩展方案### 7.1 使用对象存储（OSS）对于大规模应用，建议使用阿里云 OSS / 腾讯云 COS：```java
// 上传到 OSS
String url = ossClient.putObject(bucket, key, file.getInputStream());// 直接返回 OSS URL
result.put("url", url);
```### 7.2 图片处理集成图片处理服务：
- 压缩：TinyPNG / ImageMagick
- 缩略图：生成多尺寸
- 水印：添加版权信息---## 八、快速检查清单部署前检查：- [ ] `file.upload-path` 配置为外部目录
- [ ] 上传目录有写入权限
- [ ] WebConfig 正确映射 `/images/**`
- [ ] 拦截器排除 `/images/**`
- [ ] 数据库已初始化
- [ ] Nginx 配置了 `X-Forwarded-*` 头---## 相关文件| 文件 | 作用 |
|------|------|
| `application.properties` | 配置上传路径、数据库等 |
| `ImgUploadController.java` | 处理上传请求 |
| `Upload.java` | 文件存储工具类 |
| `WebConfig.java` | 静态资源映射配置 |
| `pom.xml` | 依赖配置（文件上传组件） |