首页/云/Docker 容器速查/存储驱动报错:graphdriver/overlay2
容器排障52 条

存储驱动报错:graphdriver/overlay2

error initializing graphdriver 或 error creating overlay mount:与内核版本、底层文件系统(d_type 支持)、磁盘空间与权限相关,先核对环境再改驱动。

Docker 容器速查云更新于 2026-10-12
查看docker info 的 Storage Driver
环境df -h 空间、dmesg 错误、文件系统类型
谨慎切换驱动不自动迁移数据

示例

示例
docker info | grep -iE 'storage driver|backing filesystem'
df -h /var/lib/docker
dmesg | tail -20
sudo du -sh /var/lib/docker/overlay2 2>/dev/null
确需更换驱动时先导出镜像与卷数据,或安排重建方案,不要直接删 /var/lib/docker。

易错点

  • 底层是网络文件系统(NFS 等)时某些驱动不受支持,先确认文件系统类型
  • 磁盘写满也会以存储驱动报错的面貌出现,排查顺序里先看 df

数据来源与参考

  • Docker 官方文档:Storage drivers 与 troubleshooting(docs.docker.com/storage/storagedriver)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌