Spring Boot Docker容器化后无法创建文件的问题求助

错误原因 #

1. 本地运行时项目是松散的文件结构，ClassPathResource能拿到本地文件系统的真实路径，但打包成Jar后，application-fe/src/assets是Jar内部的资源路径，并非容器的文件系统路径，调用resource.getFile()自然会报错。
2. 就算能拿到Jar内的路径，也不能往Jar包内部写文件——Jar是只读压缩包，容器里的Jar文件权限通常也是只读的。

解决方案 #

方案一：用容器可写目录+宿主机挂载（推荐，支持文件持久化） #

1. 修改代码，指定可写的外部路径

放弃ClassPathResource，直接定义一个可写的外部目录，建议通过配置项灵活调整：

// 可在application.yml中配置（方便不同环境修改）
// file:
//   upload:
//     path: /usr/app/assets

@Value("${file.upload.path:/usr/app/assets}")
private String uploadPath;

public void saveImage(MultipartFile image, String region, String city) throws IOException {
    if (image == null) {
        return;
    }
    // 创建存储目录（不存在则自动创建）
    File saveDir = new File(uploadPath);
    if (!saveDir.exists()) {
        saveDir.mkdirs();
    }
    // 生成目标文件
    String fileName = this.region(region, city) + ".png";
    File targetFile = new File(saveDir, fileName);
    // 写入图片内容
    image.transferTo(targetFile);
}

2. Docker部署时挂载目录

运行容器时，把容器内的/usr/app/assets挂载到宿主机目录，避免容器重启后文件丢失：

# Docker Run命令示例
docker run -d -p 8080:8080 -v /宿主机绝对路径/assets:/usr/app/assets your-spring-boot-image

如果用Docker Compose：

services:
  spring-boot-app:
    image: your-spring-boot-image
    ports:
      - "8080:8080"
    volumes:
      - ./host-assets:/usr/app/assets  # 宿主机当前目录下的host-assets挂载到容器内路径

方案二：用容器临时目录（无需持久化场景） #

如果图片不需要长期保存，用Java的临时目录即可，容器重启后文件会自动清理：

public void saveImage(MultipartFile image, String region, String city) throws IOException {
    if (image == null) {
        return;
    }
    // 获取容器内的临时目录
    String tempDir = System.getProperty("java.io.tmpdir");
    String fileName = this.region(region, city) + ".png";
    File targetFile = new File(tempDir, fileName);
    image.transferTo(targetFile);
}

内容的提问来源于stack exchange，提问作者Sonn