MacOS环境下Docker容器读取挂载目录文件触发OSError [Errno 5]错误

核心触发原因 #

• 你在容器内遍历目录时遇到的OSError: [Errno 5] Input/output error，是Docker Desktop for Mac的主机目录挂载共享层（20.10.2版本默认搭载的gRPC FUSE驱动）的已知缺陷，和你的Python代码、Dockerfile配置本身没有直接关系。
• 该版本的共享驱动对「单目录下包含10万级文件」的遍历场景适配不足：当容器内进程对挂载路径发起连续的目录枚举请求时，很容易触发挂载层的跨系统通信超时，直接返回底层I/O错误。
• 这类问题仅会在容器侧访问bind mount的宿主机路径时出现，宿主机原生文件系统下的遍历操作不受挂载层影响，因此你在Mac本地跑相同脚本完全正常。
• 你当前的启动脚本还存在一个无关的次要配置问题：镜像最终以sophia用户身份运行，但你把宿主机的ssh密钥挂载到了容器内的/root/.ssh/id_rsa路径，该路径对sophia用户无访问权限，会导致容器内ssh功能异常，但不会触发本次的目录遍历I/O错误。

分步落地修复方案 #

第一步：调整Docker文件共享驱动（最快见效） #

• 打开Docker Desktop设置页，进入文件共享配置项，将默认的gRPC FUSE文件系统切换为virtiofs驱动。该驱动针对大目录遍历、高并发文件访问场景做了性能优化，对10万级文件的遍历稳定性远高于旧版gRPC FUSE驱动。
• 修改配置后完全重启Docker Desktop服务，不要仅重启单个容器，确保新驱动完全加载生效。

第二步：临时规避挂载层性能瓶颈 #

如果切换驱动后仍偶发I/O错误，可以通过两种方式彻底绕过挂载层的性能限制：

• 调整Python遍历逻辑：把原来无间隔的连续目录枚举，改为每读取1000个目录项就休眠10ms，降低瞬间对挂载层的请求压力，避免触发通信超时。
• 把待遍历的大目录提前拷贝到容器内部存储层：将宿主机上的data/cnn目录提前打包，在容器启动后通过docker cp命令拷贝到容器的内部可写路径下，在容器内部遍历文件。该方式完全不经过Mac侧的共享挂载层，不仅不会出现I/O错误，遍历10万文件的速度也会比挂载路径下提升一个数量级。

第三步：修正启动脚本的配置缺陷 #

• 调整ssh密钥的挂载路径：把原来的-v ~/.ssh/id_rsa:/root/.ssh/id_rsa修改为-v ~/.ssh/id_rsa:/home/sophia/.ssh/id_rsa，匹配容器实际运行用户的home目录，保证ssh密钥的访问权限正常。
• 不需要对现有Dockerfile做额外修改，当前镜像的基础配置不会触发本次的目录遍历问题。

验证修复效果的方式：重启配置后进入容器，在data/cnn路径下执行ls | wc -l，如果可以正常输出接近99000的文件计数，就说明挂载层已经恢复稳定。

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