Docker部署双MySQL容器时触发MySQL[2002]套接字连接错误

嘿，我看到你跟着DigitalOcean的教程完成Laravel单容器部署后，新增测试MySQL容器时遇到了ERROR 2002连接问题，这在Docker环境里其实是挺常见的小坑，我来帮你捋清楚原因和解决办法：

核心问题分析 #

你碰到的这个错误，本质上是两个问题叠加导致的：

1. MySQL客户端的默认连接逻辑：当你在容器里直接敲mysql命令时，客户端默认会尝试用Unix套接字（就是那个/var/run/mysqld/mysqld.sock文件）连接，而不是TCP/IP。但MySQL容器里的套接字可能因为服务启动异常、路径配置问题，导致客户端找不到它。
2. 两个MySQL容器共享数据卷的致命冲突：你的db和db_test都挂载了同一个dbdata卷到/var/lib/mysql/，这相当于两个MySQL实例抢着读写同一份数据文件，大概率会导致其中一个甚至两个数据库服务启动异常，自然连不上。

分步解决办法 #

1. 先临时解决连接问题：强制用TCP/IP连接 #

不用管套接字的事，直接指定用TCP连接本地MySQL，执行命令时加上-h 127.0.0.1参数：

# 连接主数据库容器
docker exec -it todo_db mysql -h 127.0.0.1 -u root -p
# 连接测试数据库容器
docker exec -it todo_db_test mysql -h 127.0.0.1 -u root -p

输入密码ent3r1n就能正常登录了，这一步能快速验证数据库服务本身是否正常。

2. 彻底解决数据卷冲突问题（必须做） #

两个MySQL容器绝对不能共享同一个数据卷，否则数据会乱套。修改你的docker-compose.yml：
首先在volumes部分新增测试环境的独立卷：

#Volumes
volumes:
  dbdata:
    driver: local
  dbdata_test:  # 给测试库单独建个卷
    driver: local

然后修改db_test的配置，换成新的卷，最好把数据库名也改成todo_test区分开：

db_test:
  image: mysql:5.7.22
  container_name: todo_db_test
  restart: unless-stopped
  tty: true
  ports:
    - "3307:3306"
  environment:
    MYSQL_DATABASE: todo_test  # 测试库用单独的数据库名
    MYSQL_ROOT_PASSWORD: ent3r1n
    SERVICE_TAGS: dev
    SERVICE_NAME: mysql_test
  volumes:
    - dbdata_test:/var/lib/mysql/  # 挂载独立的测试卷
    - ./mysql/my.cnf:/etc/mysql/my.cnf
  networks:
    - app-network

修改完后，删除旧的容器和卷，重新启动：

docker-compose down -v
docker-compose up -d

3. 排查MySQL服务是否正常启动（可选） #

如果还是连不上，可以查看容器日志，看看数据库启动时有没有报错：

# 查看主数据库日志
docker logs todo_db
# 查看测试数据库日志
docker logs todo_db_test

如果日志里提示数据目录损坏，那就是之前共享卷导致的，用上面的方案2修复后就能解决。

额外提醒 #

• 你的Laravel应用连接数据库时，记得用容器服务名作为host（比如db或者db_test），而不是localhost，因为在Docker的桥接网络里，容器之间通过服务名就能互相访问。
• 测试环境和主环境的数据库一定要完全隔离，不管是数据卷还是数据库名，避免不小心把测试数据写到主库或者反过来。

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