Docker Compose部署MySQL容器无法连接本地数据库问题排查

• 默认连接方式的坑：执行mysql -u root -p时，客户端默认优先走本地socket文件/var/run/mysqld/mysqld.sock连接，但Docker Compose启动的容器可能因为配置或初始化问题，没生成这个socket，或者路径不对。而你用Dockerfile构建的容器要么默认配置正确，要么你之前无意识用了TCP连接（比如加了-h参数）。
• MySQL未完全启动：MySQL容器启动需要跑初始化脚本、创建系统库，这个过程需要几十秒。如果你在容器刚起来就跑连接命令，socket文件还没生成，自然报错。Dockerfile构建的容器你可能是等了一会儿才操作的，所以没问题。
• Compose配置覆盖了默认socket设置：如果你的docker-compose.yml里自定义了command参数，或者挂载了自己的my.cnf，可能修改了socket参数（比如改成了/tmp/mysql.sock），甚至禁用了socket监听，导致默认连接找不到目标文件。

• 直接用TCP连接绕开socket：执行命令时加-h 127.0.0.1，强制客户端用TCP连接，命令改成：mysql -u root -p -h 127.0.0.1，这是最快的临时解决办法。
• 确认MySQL服务是否正常运行：进入容器后先跑ps aux | grep mysqld，看MySQL进程是否在。如果没运行，看容器日志docker logs <你的mysql容器名>，排查初始化错误（比如密码格式不对、挂载目录权限问题）。
• 检查socket文件的存在性：进容器后看/var/run/mysqld/下有没有mysqld.sock。如果没有：
  • 检查是否挂载了自定义my.cnf，里面的socket参数是不是改了路径，要是改成了/tmp/mysql.sock，连接时就得加--socket=/tmp/mysql.sock。
  • 看docker-compose.yml里的command有没有覆盖默认启动命令，导致MySQL没加载默认socket配置。
• 等MySQL初始化完成再操作：在Compose的MySQL服务里加健康检查，确保服务就绪后再操作：

  healthcheck:
    test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
    interval: 5s
    timeout: 5s
    retries: 5
  

  之后可以用docker-compose wait mysql命令，等服务健康了再进入容器执行连接命令。
• 对比Dockerfile和Compose的配置差异：把两者的环境变量、启动命令、挂载文件逐一对比，找出不一致的地方，比如MYSQL_ROOT_PASSWORD是否正确设置，有没有遗漏必要的配置项。

内容的提问来源于stack exchange，提问作者simone.benati