使用Docker运行MongoDB并通过Robo 3T访问时遇overlayfs错误求助

你碰到的是Docker存储驱动的典型问题——overlay2（Docker默认推荐的存储驱动）要求底层文件系统必须支持d_type（目录项类型）特性，而你的系统里上层文件系统不满足这个要求，所以内核抛出了这个错误。下面一步步帮你排查和解决：

1. 确认Docker当前使用的存储驱动 #

先执行这条命令，查看你的Docker正在使用的存储驱动：

docker info | grep "Storage Driver"

如果输出显示Storage Driver: overlay2，那确实是这个驱动的适配问题。

2. 检查底层文件系统是否支持d_type #

针对XFS文件系统 #

如果/var/lib/docker（Docker默认的存储目录）所在分区是XFS格式，用以下命令查看是否开启了ftype=1（ftype=1就代表支持d_type）：

xfs_info /var/lib/docker

在输出结果里找ftype=1的标识，如果显示的是ftype=0，说明该分区没有开启这个特性，这就是问题根源。

针对ext4文件系统 #

ext4默认是支持d_type的，除非挂载时用了特殊参数禁用了该特性。可以用mount | grep /var/lib/docker查看挂载参数，确认没有相关禁用项即可。

3. 具体修复方案 #

方案一：重新格式化XFS分区（需备份数据） #

如果是XFS分区的ftype=0问题，需要按以下步骤操作（注意：操作前务必备份/var/lib/docker里的镜像、容器、卷等数据）：

• 卸载目标分区：sudo umount /var/lib/docker
• 重新格式化分区，添加-n ftype=1参数：

sudo mkfs.xfs -n ftype=1 /dev/[你的分区设备名]

• 重新挂载分区，然后重启Docker服务：sudo systemctl restart docker
• 恢复之前备份的数据

方案二：临时切换到其他存储驱动 #

如果暂时无法重新格式化分区，可以切换到devicemapper驱动应急（注意：该驱动性能不如overlay2，不推荐长期使用）：

• 编辑或新建Docker配置文件/etc/docker/daemon.json，添加以下内容：

{
  "storage-driver": "devicemapper"
}

• 重启Docker服务：sudo systemctl restart docker

额外检查：挂载卷的文件系统 #

你启动命令里挂载的/var/lib/mongo和/home/naggappan/mongo.conf所在的文件系统，也建议确认是否支持d_type，避免后续其他容器出现类似问题。

验证修复 #

重新运行你的MongoDB启动命令：

sudo docker run -v /var/lib/mongo:/data/db -v /home/naggappan/mongo.conf:/etc/mongo.conf -p 27017:27017 mongo -f /etc/mongo.conf

之后查看syslog，应该不会再出现overlayfs的报错了。

内容的提问来源于stack exchange，提问作者Naggappan Ramukannan