必须使用-v参数将容器内日志、配置、上传文件及嵌入式数据库目录映射到宿主机绝对路径，如-v /opt/myapp/logs:/app/logs，确保容器重启或删除后数据不丢失，并需提前创建宿主机目录、设置正确权限、验证挂载生效。
Java 应用在 Docker 中运行时，若需持久化日志、配置、上传文件或数据库数据等核心内容，必须借助 -v（volume）参数将容器内路径映射到宿主机物理路径。这能确保容器重启、重建甚至删除后，关键数据不丢失。
明确 Java 应用需要持久化的目录
不是所有路径都需要挂载。常见需持久化的 Java 目录包括：
-
日志目录：如
/app/logs（Spring Boot 默认logging.file.path指向的路径） -
外部配置目录：如
/app/config，存放application-prod.yml等动态配置 -
用户上传文件目录：如
/app/uploads，避免因容器销毁导致图片/附件丢失 -
嵌入式数据库数据目录：如 H2 的
~/h2db/或 SQLite 的/app/data/
使用 -v 正确挂载宿主机路径
语法为 -v <宿主机绝对路径>:<容器内路径>[:<选项>]。务必使用绝对路径，相对路径会挂载失败或行为异常。
示例（启动 Spring Boot JAR 包）：
linux-sysadmin
下载
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
立即学习“Java免费学习笔记（深入）”；
docker run -d \ -v /opt/myapp/logs:/app/logs \ -v /opt/myapp/config:/app/config \ -v /opt/myapp/uploads:/app/uploads \ -p 8080:8080 \ --name my-java-app \ my-java-image:1.0
注意：
• 宿主机目录（如 /opt/myapp/logs）需提前创建并赋予容器进程可读写权限（如 chown -R 1001:1001 /opt/myapp，对应镜像中 Java 进程 UID/GID）
• 容器内路径必须与应用实际写入路径一致（可通过 java -Dlogging.file.path=/app/logs ... 显式指定）
避免常见挂载陷阱
以下问题会导致挂载失效或数据未持久化：
-
容器内路径被应用覆盖创建：若应用在启动时自动创建
/app/logs并设为只读，宿主机挂载将被忽略——应在启动前确保该路径为空或由 Docker 自动初始化 -
权限不匹配：Java 进程以非 root 用户（如
user 1001）运行时，宿主机对应目录需对该 UID 可写，否则日志写入失败 -
误用匿名卷或命名卷：
-v logs-volume:/app/logs属于命名卷，数据存于 Docker 管理区域，虽持久但不易直接访问和备份；生产环境推荐显式绑定宿主机路径 -
挂载覆盖已有文件：若容器镜像中
/app/config/application.yml已存在，挂载空目录会隐藏它——应先将默认配置复制到宿主机再挂载
验证挂载是否生效
运行容器后，可通过以下方式确认：
- 执行
docker exec -it my-java-app ls -l /app/logs，查看目录是否为total 0且属主匹配 - 在宿主机
/opt/myapp/logs中手动创建测试文件，进入容器检查是否可见 - 触发 Java 应用写日志，观察宿主机对应路径下是否生成
myapp.log等文件 - 执行
docker inspect my-java-app | grep -A 10 Mounts，核对Source和Destination字段
