根本原因是docker容器默认使用可写层(cow机制),数据随容器生命周期销毁;必须通过命名卷挂载、路径严格对齐、权限正确配置并三步验证,才能实现持久化。

容器重启后数据丢失,根本不是故障,而是默认行为——Docker 容器的可写层随生命周期销毁,不挂载持久化存储,数据必然消失。关键不在“重启”,而在“有没有真正把数据落到 Docker 管理的持久位置”。下面从架构设计角度直击核心,避开高频误用。
一、拒绝匿名卷:命名卷是生产环境唯一推荐方式
匿名卷(如 -v /var/lib/mysql)每次 docker run 都会新建一个卷,旧数据被隔离,新容器永远读不到。这不是 bug,是设计逻辑。
- 必须显式使用带名字的卷,例如
-v mysql-data:/var/lib/mysql - 启动前先创建卷:
docker volume create mysql-data,便于后续排查和备份 - 通过
docker volume inspect mysql-data查看真实路径,确认挂载生效
二、路径对齐:容器内路径必须100%匹配官方默认数据目录
PostgreSQL 必须写入 /var/lib/postgresql/data,MySQL 是 /var/lib/mysql,Neo4j 是 /data——这些路径由镜像固化,改不了。挂载时错一个字符、少一层目录,数据就掉进可写层,重启即丢。
- 错误示例:
-v pgdata:/var/lib/postgresql(漏了/data) - 正确写法:
-v pgdata:/var/lib/postgresql/data - 用
docker exec -it 容器名 ls -l /var/lib/xxx验证目标目录是否存在且为空(挂载成功后应为挂载点,非空目录说明挂载失败)
三、权限兜底:绑定挂载时必须适配容器内用户 UID/GID
若用 -v /host/path:/var/lib/mysql 这类绑定挂载,宿主机目录权限不匹配,容器内进程(如 mysql 用户 UID=999)无法写入,自动退回到临时可写层。
- 查容器内用户 ID:
docker exec 容器名 id -u mysql或查看官方文档 - 修复宿主机目录权限:
sudo chown -R 999:999 /host/path - 生产环境更建议优先用命名卷,Docker 自动处理权限,省去手动干预
四、验证闭环:三步确认持久化真正生效
别只看命令写了没,要验证数据是否真的落盘、能否跨容器存活。
- 启动容器并写入测试数据(如建库、插一条记录)
- 执行
docker stop && docker rm && docker run重建容器(不删卷) - 进入新容器检查原数据是否存在,例如:
ls /var/lib/mysql/your_db_name或查询表记录











