Windows 10环境下Laradock初始化MySQL数据库失败求助

问题梳理 #

你先后遇到了两个关联的启动故障：

1. 初始报错：--initialize specified but the data directory has files in it——挂载的本地MySQL数据目录残留了旧文件，导致初始化流程被中断。
2. 清理数据目录后新报错：'aio write' returned OS error 122——Windows 10 Home的Docker环境（无论是WSL1还是Hyper-V后端）不支持MySQL 8.0默认启用的InnoDB异步IO（AIO）功能，引发文件操作失败。

分步解决方案 #

第一步：彻底清理残留数据与容器 #

要确保没有任何残留数据干扰初始化，需要同时清理容器卷和本地目录：

1. 停止并彻底移除相关容器及关联卷：

   docker-compose down -v --remove-orphans
   

2. 手动删除本地挂载的MySQL数据目录（确保完全清空）：
   如果你用Git Bash类终端：

   rm -rf ~/.laradock/data/mysql
   

   如果你用Windows命令提示符：

   rmdir /s /q %USERPROFILE%/.laradock/data/mysql
   

第二步：修改MySQL配置禁用AIO #

针对Windows 10 Home的环境限制，需要关闭InnoDB的异步IO特性：

1. 打开Laradock目录下的mysql/my.cnf文件（如果不存在就新建一个）。
2. 在[mysqld]区块中添加以下配置：

   innodb_use_native_aio = 0
   

   这个参数会强制InnoDB使用同步IO，绕过Windows环境下的AIO支持限制。

第三步：重新构建并启动容器 #

让配置修改生效后，重新启动MySQL容器：

1. 重新构建MySQL镜像：

   docker-compose build mysql
   

2. 启动MySQL容器：

   docker-compose up -d mysql
   

补充说明 #

为什么Windows 7可以正常运行？因为Windows 7上的Docker Toolbox依赖VirtualBox虚拟机，其文件系统与IO处理逻辑和Windows 10 Home的Hyper-V/WSL1环境不同，刚好兼容默认的AIO配置；而Windows 10 Home的Docker环境对AIO支持有限，所以必须手动禁用该特性。

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