Laravel+Docker环境数据库连接异常：终端与Web应用无法同时正常工作

问题原因 #

Web应用容器和数据库容器处于同一个Docker网络app-network中，因此容器内可以通过服务名database解析到数据库容器IP；但本地终端不在这个Docker网络里，无法识别database这个主机名，只能通过映射到本地的端口（localhost:3306）连接数据库。反过来，若把DB_HOST改成localhost，Web容器会尝试连接自身的3306端口（而非数据库容器），导致连接失败。

解决方案 #

方案1：本地hosts映射（推荐） #

在本地系统的hosts文件中添加映射，让database指向127.0.0.1，这样本地终端和Web容器都能使用相同的ENV配置：

1. 打开hosts文件：
   • Windows：C:\Windows\System32\drivers\etc\hosts（需管理员权限编辑）
   • Linux/macOS：/etc/hosts（使用sudo vi /etc/hosts编辑）
2. 添加一行内容：

   127.0.0.1 database
   

3. 保存文件后，本地终端使用原ENV配置（DB_HOST=database）即可正常执行迁移命令，Web应用不受影响。

方案2：进入Web容器执行命令 #

直接在Web应用容器内部执行Laravel命令，容器内处于Docker网络中，能正常解析database服务名：

1. 先查看Web容器的名称或ID：

   docker ps
   

2. 进入容器并执行命令（替换web-container-name为实际容器名）：

   docker exec -it web-container-name php artisan migrate
   

方案3：区分本地与容器的环境配置 #

创建本地专用的环境配置文件，让终端和容器使用不同的DB_HOST：

1. 在项目根目录创建.env.local文件，内容如下：

   DB_CONNECTION=mysql
   DB_HOST=localhost
   DB_PORT=3306
   DB_DATABASE=products
   DB_USERNAME=homestead
   DB_PASSWORD=secret
   

2. 本地终端执行命令时指定使用该配置文件：

   php artisan migrate --env=local
   

3. Docker中的Web容器继续使用原.env文件（DB_HOST=database）即可正常连接数据库。

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