Docker环境下MySQL初始化崩溃问题排查求助

一、核心诱因：端口冲突（最可能的原因） #

Docker的MySQL和MAMP的服务大概率抢占了同一端口，导致双方都无法正常启动：

• MySQL默认用3306端口，如果Docker的MySQL容器配置了映射3306到本地，而MAMP的MySQL也在使用3306，就会直接导致Docker的MySQL初始化崩溃；
• Apache默认用80/8080端口，若Docker容器（比如PHP环境搭配的Nginx/Apache）占用了这两个端口，MAMP的Apache就会启动失败。

排查&解决步骤： #

1. 检查本地端口占用：
   • Windows：打开命令提示符，执行 netstat -ano | findstr "3306 80 8080"，查看哪个进程占用了目标端口；
   • macOS/Linux：打开终端，执行 lsof -i :3306 和 lsof -i :80，找到占用端口的进程ID（PID）。
2. 针对性处理：
   • 若MAMP服务占用端口：打开MAMP偏好设置，把MySQL端口改成3307、Apache端口改成8081，重启MAMP；
   • 若Docker容器占用端口：修改docker-compose.yml里的端口映射，比如把MySQL的3306:3306改成3307:3306，Web服务的80:80改成8081:80，然后执行 docker-compose down && docker-compose up -d 重启容器。

二、Docker MySQL初始化崩溃的其他排查点 #

如果端口没问题，再查以下内容：

1. 数据目录权限异常：
   Docker挂载的MySQL数据目录（比如./mysql/data）权限不对，导致MySQL进程无法读写。解决：在本地终端执行 sudo chown -R 999:999 ./mysql/data（999是MySQL容器内的默认用户ID），然后重启容器。
2. 数据目录损坏：
   之前异常关闭容器导致MySQL数据文件损坏，初始化时无法加载。解决：先备份./mysql/data目录，然后删除它，重新启动容器让MySQL重新初始化；如果需要恢复数据，用备份文件替换即可。
3. 配置文件参数错误：
   检查docker-compose.yml里MySQL的环境变量，比如MYSQL_ROOT_PASSWORD是否为空、MYSQL_DATABASE等参数格式是否合法；同时确认挂载路径是否正确，比如./mysql/data:/var/lib/mysql对应的本地目录是否存在。

三、MAMP Apache启动失败的额外排查点 #

1. 配置文件语法错误：
   打开MAMP的Apache配置文件（macOS路径：/Applications/MAMP/conf/apache/httpd.conf，Windows对应路径自行查找），检查是否有语法错误；也可以执行 /Applications/MAMP/Library/bin/apachectl configtest（macOS）或对应Windows命令，直接验证配置合法性。
2. MAMP组件损坏：
   若配置没问题，大概率是MAMP的Apache组件损坏，直接卸载重装MAMP即可。

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