Docker升级后存储驱动报错需安全迁移旧数据：先停服务并备份原目录，再配置新data-root和overlay2驱动（含override_kernel_check），仅迁移image、overlay2（若完好）和volumes，最后启动验证并重建容器。
Docker 升级后出现存储驱动（如 overlay2、aufs、btrfs）报错，常见于升级前后默认驱动不一致、内核模块缺失、或旧数据目录结构与新版本不兼容。此时直接启动服务可能失败，但已有镜像、容器、卷等数据仍可抢救——关键不是重装，而是安全迁移旧数据到新驱动兼容的路径和格式。
? 先确认报错类型和当前状态
运行以下命令快速定位问题：
sudo systemctl status docker sudo journalctl -u docker --since "1 hour ago" | tail -n 30 docker info | grep -E "(Storage|Driver|Root)"
重点关注：
- 错误是否含
failed to start daemon: error initializing graphdriver或failed to load overlay2； - 当前
Storage Driver是否为overlay2（Docker 20.10+ 强制推荐）； -
Docker Root Dir是否仍是/var/lib/docker，但内容已损坏或驱动不匹配。
⚠️ 注意：若
docker info都无法执行，说明守护进程根本没起来，必须先修复驱动或迁移数据再启动。
?️ 安全迁移旧数据的四步法（适配升级后驱动不兼容）
✅ 步骤1：停用并保留旧数据，不删不覆盖
sudo systemctl stop docker # 确保无残留进程 sudo pkill -f docker # 备份原目录（带时间戳，防误操作） sudo mv /var/lib/docker /var/lib/docker.pre-upgrade-$(date +%Y%m%d)
这一步不是删除，而是隔离。所有旧数据仍在原处，随时可回退。
✅ 步骤2：创建新数据目录并配置兼容驱动
假设目标路径为 /data/docker（已挂载、ext4/xfs 格式、有足够空间）：
sudo mkdir -p /data/docker sudo chown -R root:root /data/docker sudo chmod 700 /data/docker
编辑 /etc/docker/daemon.json，显式指定 storage driver 和 data-root：
{
"data-root": "/data/docker",
"storage-driver": "overlay2",
"storage-opts": [
"overlay2.override_kernel_check=true"
]
}✅
overlay2.override_kernel_check=true是关键——它允许在较老内核（如 CentOS 7 默认 3.10）上强制启用 overlay2（Docker 24+ 默认要求 4.0+，该选项绕过检查但需确保实际支持）。
✅ 步骤3：迁移可兼容的数据（非全量复制）
旧 /var/lib/docker.pre-upgrade-* 中，只有部分子目录可安全复用：
-
image/、overlay2/（若原驱动就是 overlay2，且未损坏）→ 可整体迁移 -
volumes/→ 必须迁移（用户数据卷，结构通用） -
network/、containers/、plugins/→ 不建议直接复制（含运行时状态、PID、旧驱动元数据，易冲突）
推荐做法：
# 只迁移镜像层 + 数据卷（最安全） sudo rsync -a /var/lib/docker.pre-upgrade-*/image/ /data/docker/image/ sudo rsync -a /var/lib/docker.pre-upgrade-*/overlay2/ /data/docker/overlay2/ sudo rsync -a /var/lib/docker.pre-upgrade-*/volumes/ /data/docker/volumes/ # 忽略 containers/、tmp/、trust/ 等运行时目录
? 提示：
overlay2目录若存在且ls -l */diff能看到有效子目录，说明镜像层完好；若报invalid argument或no such file or directory，则跳过overlay2/，改用docker load导入镜像备份。
✅ 步骤4：启动验证 + 逐步恢复业务
sudo systemctl start docker sudo docker info | grep -E "(Root|Driver)"
应显示：
Docker Root Dir: /data/docker Storage Driver: overlay2
然后验证：
-
docker images→ 应列出迁移的镜像 -
docker volume ls→ 应看到原有卷 - 启动一个测试容器：
docker run --rm hello-world
✅ 若成功，再逐个重建容器（用 docker commit 或 docker run -v 挂载旧卷），不要直接复用旧 containers/ 目录。
? 补充：如果旧数据完全不可读怎么办？
-
用
docker save（升级前）或docker export（容器导出）备份过的镜像/容器：docker load -i backup-images.tar docker import backup-container.tar myapp:latest
从宿主机直接提取卷数据（
/var/lib/docker.volumes/xxx/_data）手动拷贝到新卷挂载点。日志类数据（如
/var/lib/docker/containers/*/xx-json.log）无需迁移，新容器会生成新日志。
迁移不是“复制粘贴”，而是“解耦重建”。升级后的驱动报错本质是版本契约变更，安全做法是：停服务 → 隔离旧数据 → 显式声明新驱动 → 只迁静态资产（镜像+卷）→ 用新机制重建运行态。这样既保住业务数据，又避免底层不兼容引发的隐性故障。
