Laravel Sail无法连接MySQL容器：双项目冲突问题求助

可能的原因及对应解决方案 #

1. 端口冲突导致容器无法正常启动 #

两个项目的Sail默认都映射3306端口到主机，会导致只有一个MySQL容器能成功绑定端口，另一个容器启动失败或无法正常提供服务。

• 打开其中一个项目的.env文件，修改DB_PORT为未被占用的端口（比如3307）
• 重启该项目的Sail容器：

  ./vendor/bin/sail down && ./vendor/bin/sail up -d
  

• 用docker ps命令验证两个MySQL容器的端口映射，确保分别对应不同的主机端口（如0.0.0.0:3306->3306/tcp和0.0.0.0:3307->3306/tcp）

2. 项目容器内数据库连接配置错误 #

主机能通过Workbench连接是因为用了端口映射，但容器内的Laravel项目需要通过Docker服务名访问MySQL，而非localhost或主机IP：

• 检查项目.env文件，确保DB_HOST设置为mysql（Sail默认的MySQL服务名），而非127.0.0.1或localhost
• 确认容器内项目的DB_PORT使用3306（MySQL容器内部的默认端口），主机连接才用映射的外部端口

3. Docker网络配置冲突 #

每个Sail项目默认创建独立的Docker网络，若网络未正确生成或容器未加入对应网络，会导致容器间无法通信：

• 彻底清除项目的容器、卷和网络：

  ./vendor/bin/sail down -v
  

• 重新启动Sail：

  ./vendor/bin/sail up -d
  

• 用docker network ls查看网络列表，确认两个项目各自拥有独立的网络（格式通常为项目目录名_sail）

4. MySQL用户权限限制 #

若数据库用户仅允许localhost访问，容器内的Laravel项目（属于Docker网络内的其他主机）会被拒绝连接：

• 进入MySQL容器：

  ./vendor/bin/sail mysql
  

• 查看当前用户的访问权限：

  SELECT user, host FROM mysql.user;
  

• 若你的DB_USER对应的host是localhost，修改为允许任意主机访问：

  ALTER USER 'your_db_username'@'%' IDENTIFIED BY 'your_db_password';
  FLUSH PRIVILEGES;
  

  替换your_db_username和your_db_password为.env中对应的配置值

5. Laravel配置缓存残留 #

旧的数据库配置可能被缓存，导致容器内项目使用错误的连接信息：

• 清除配置缓存：

  ./vendor/bin/sail artisan config:clear
  

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