Docker主版本升级需提前识别存储驱动兼容性风险：25.0+移除devicemapper，27.0+弃用overlay2并拒绝启动旧数据目录；迁移须分步验证、备份回退，确保内核≥4.0、xfs启用ftype=1，通过docker save/load重建镜像格式，并验证驱动切换后容器读写与挂载正常。
Docker 主版本升级常伴随存储驱动的默认值调整甚至弃用，直接更新可能导致服务启动失败。平滑过渡的关键不是跳过变更，而是提前识别风险、分步验证、留出回退路径。
看清版本与驱动的兼容关系
Docker 25.0+ 已完全移除 devicemapper 支持；27.0+ 不仅弃用 overlay2，还会在检测到 /var/lib/docker/image/overlay2 目录时直接拒绝启动，并报错 FATAL: storage driver overlay2 is deprecated and disabled。这意味着：
- 若当前用的是 devicemapper（尤其是 loop-lvm 模式），必须在升级前迁移到 overlay2；
- 若已在用 overlay2，升级到 27.0+ 前需确认镜像数据是否为新格式（v27 要求使用 image manifest v2 schema 2 或 OCI 格式），旧版 overlay2 数据目录可能被拒绝加载。
devicemapper → overlay2 的迁移实操要点
这是目前最常见也最需谨慎处理的过渡场景：
- 确保目标系统内核 ≥ 4.0（overlay2 最低要求），且支持 overlay 模块（
modprobe overlay && lsmod | grep overlay） - 停止 Docker 服务后，不要直接修改
daemon.json切换驱动，先用docker info确认当前驱动和 root dir - 备份完整
/var/lib/docker（如cp -a /var/lib/docker /var/lib/docker.bak） - 编辑
/etc/docker/daemon.json，添加：{"storage-driver": "overlay2", "data-root": "/var/lib/docker"}（显式声明避免 fallback） - 首次启动前，建议加
--log-level=debug启动 dockerd，观察日志中是否出现overlay2: cannot mount, invalid argument类错误——多因 xfs 文件系统未启用ftype=1
overlay2 数据格式升级适配（v26 → v27+）
v27 强制要求镜像元数据符合 OCI 规范，旧版 Docker（如 20.x）生成的 overlay2 镜像目录结构可能不被识别：
- 升级前运行
docker system prune -a --volumes清理无用数据，减少迁移负担 - 对关键镜像执行
docker save <image> | docker load，强制重建为新格式 - 若使用 registry，可先推送到私有仓库再拉取，天然完成格式转换
- 检查
/var/lib/docker/image/overlay2/imagedb/content/sha256/下文件是否为 JSON 格式且含"schemaVersion": 2
迁移后必须验证的三件事
驱动切换成功 ≠ 应用运行正常：
- 运行
docker info | grep -E "(Storage|Root)"，确认输出为Storage Driver: overlay2且Docker Root Dir路径正确 - 启动一个基础容器（如
alpine:latest）并写入文件，然后docker commit新镜像，验证读写与持久化正常 - 检查原业务容器是否能正常 attach、logs、exec —— 特别注意 volume 挂载路径权限是否因 root dir 变更而失效
