Docker无法持久化Java后端生成文件，尝试Volume仍无效

问题概述 #

Java后端应用运行时会在容器内/root/projects/example_PROD/backend目录下（与src、pom.xml同级）生成文件，但修改代码重建容器后，这些文件会被删除。尝试过两种Volume配置（直接挂载Docker卷路径、命名卷挂载整个后端目录）均未生效。

错误原因分析 #

你之前的配置错误地将整个后端目录挂载到Volume：

1. 直接挂载Docker卷的绝对路径：/var/lib/docker/volumes/example_prod_example-backend-volume/_data:/root/projects/example_PROD/backend，这种方式绕过Docker卷管理机制，且会覆盖容器内构建好的应用代码，导致重建容器时新代码无法生效。
2. 命名卷挂载整个后端目录：example-backend-volume:/root/projects/example_PROD/backend，容器启动时会用卷内旧内容覆盖新构建的应用目录，既破坏应用代码更新，也无法正确持久化生成文件。

正确思路是仅挂载生成文件所在的子目录，既保证应用代码正常更新，又能持久化目标文件。

解决方案步骤 #

1. 确认生成文件的具体路径 #

进入运行中的后端容器，定位生成文件的实际子目录：

docker exec -it examle-docker-backend find /root/projects/example_PROD/backend -type f -mtime -1

这条命令会列出后端目录1小时内修改过的文件，据此确定生成文件所在的子目录（比如/root/projects/example_PROD/backend/generated或/root/projects/example_PROD/backend/uploads）。

2. 修改docker-compose.yml配置 #

步骤1：添加命名卷定义

在volumes区块下新增用于持久化生成文件的命名卷：

volumes:
  examle-docker-db: { }
  example-backend-files: { }  # 新增：存储后端生成文件的卷

步骤2：更新backend服务的volumes配置

删除之前错误的整个目录挂载，替换为仅挂载生成文件的子目录：

backend:
  container_name: examle-docker-backend
  build: ./backend
  volumes:
    - example-backend-files:/root/projects/example_PROD/backend/[你的生成文件子目录]  # 替换为实际子目录路径
  ports:
    - "8080:8080"
    - "8888:8888"
  depends_on:
    - examledb
  networks:
    - examle-docker-network
  environment:
    SPRING_DATASOURCE_URL: jdbc:postgresql://examle-docker-db:5432/examle
  restart: unless-stopped

3. 验证配置效果 #

1. 重建并启动后端容器：

docker-compose up -d --build backend

2. 运行应用生成文件，进入容器检查文件是否存在：

docker exec -it examle-docker-backend ls /root/projects/example_PROD/backend/[你的生成文件子目录]

3. 修改代码后再次重建容器：

docker-compose up -d --build backend

4. 再次检查生成文件是否保留，且应用新代码正常运行。

关键注意事项 #

• 禁止将容器内的应用代码目录（含src、pom.xml的目录）直接挂载到Volume，否则会导致新构建代码被卷内旧内容覆盖，无法更新应用。
• 优先使用Docker命名卷管理持久化数据，避免手动指定绝对路径引发的环境兼容问题。

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