Docker在Windows下挂载卷导致容器崩溃问题求助

可能的突发原因 #

• Windows系统更新影响：2023年6月前后的Windows累积更新（如KB5027231）可能改动了WSL2与本地文件系统的交互逻辑，导致Docker挂载Windows目录时出现IO兼容性问题。
• Docker Desktop版本bug：若Docker自动更新到4.20.x这类新版本，其WSL2集成或卷挂载机制可能存在缺陷，触发IO错误。
• WSL2虚拟磁盘损坏：WSL2的.vhdx虚拟磁盘出现坏块，Docker通过WSL2挂载Windows目录时，读写操作触发错误。
• 杀毒软件拦截：近期更新的杀毒软件（含Windows Defender）可能将Docker卷挂载操作判定为可疑行为，拦截文件读写引发IO报错。

解决步骤 #

1. 修复WSL2虚拟磁盘 #

关闭所有容器和Docker Desktop，打开管理员权限的PowerShell执行以下命令：

# 关闭所有WSL实例
wsl --shutdown
# 导出当前WSL分发版备份
wsl --export Ubuntu backup.tar
# 注销当前分发版
wsl --unregister Ubuntu
# 重新导入分发版
wsl --import Ubuntu C:\wsl\Ubuntu backup.tar

（注：用wsl --list可查看你的分发版名称，默认一般为Ubuntu）
操作完成后重启Docker Desktop，测试卷挂载是否恢复正常。

2. 回滚Docker Desktop版本 #

卸载当前Docker Desktop，安装2023年6月8日前的稳定版本（如4.19.0），安装后关闭自动更新，再测试挂载功能。

3. 卸载近期Windows更新 #

打开Windows设置→更新和安全→查看更新历史记录，找到6月8日前后安装的KB补丁，卸载后重启系统，再尝试容器挂载。若问题解决，可暂时关闭Windows自动更新，等待微软修复兼容性问题。

4. 调整杀毒软件设置 #

临时关闭Windows Defender实时保护（仅用于测试），或将Docker工作目录、挂载的源码目录加入杀毒软件白名单，排除扫描。第三方杀毒软件同理，检查是否存在针对容器或WSL的拦截规则并调整。

5. 切换到Hyper-V后端（备选） #

若WSL2后端问题无法解决，可切换到Hyper-V：打开Docker Desktop设置→General，取消勾选"Use the WSL 2 based engine"，勾选"Use Hyper-V"，重启Docker后测试挂载。

验证操作 #

每次调整后，启动容器并执行以下命令确认文件状态：

docker exec -it <你的容器名> ls -l ./docker_intern.sh

若能正常列出文件，再尝试执行脚本，检查IO错误是否消失。

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