
Laravel Sail 项目中数据库迁移正常但用户注册时抛出 “Connection refused” 错误,根本原因在于 PHP 应用容器无法通过 DB_HOST=0.0.0.0 正确连接 MySQL 容器,需将 DB_HOST 改为 Docker 网络网关 IP(如 172.17.0.1)。
laravel sail 项目中数据库迁移正常但用户注册时抛出 “connection refused” 错误,根本原因在于 php 应用容器无法通过 `db_host=0.0.0.0` 正确连接 mysql 容器,需将 `db_host` 改为 docker 网络网关 ip(如 `172.17.0.1`)。
在 Laravel Sail 环境中,应用(PHP/Apache/Nginx)与数据库(MySQL)运行在独立的 Docker 容器中,并通过自定义桥接网络(如 sail 网络)通信。此时,DB_HOST 的值不能是 0.0.0.0 或 localhost——前者绑定的是宿主机回环接口,后者在容器内指向容器自身,均无法访问同网络下的 MySQL 容器。
正确做法是让 PHP 应用通过 Docker 内部网络使用 MySQL 容器的服务名(默认为 mysql)或所在网络的网关地址(适用于部分特殊网络配置或 bridge 默认网络场景)。
✅ 推荐方案(最佳实践):使用服务名 mysql
Sail 默认在 docker-compose.yml 中定义了 mysql 服务,且所有 Sail 容器(laravel.test, mysql, redis 等)均加入同一自定义网络 sail。因此,只需将 .env 中的:
DB_HOST=0.0.0.0
改为:
DB_HOST=mysql
并确保 DB_PORT 保持为容器内 MySQL 的标准端口 3306(而非宿主机映射端口 4306):
DB_PORT=3306
完整修正后的 .env 数据库配置应为:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
DB_CONNECTION=mysql DB_HOST=mysql DB_PORT=3306 DB_DATABASE=example_app DB_USERNAME=sail DB_PASSWORD=password
⚠️ 注意:DB_PORT 在容器间通信时必须填写 MySQL 容器内部监听的端口(即 3306),而不是宿主机映射的 4306。后者仅用于本地 CLI 工具(如 TablePlus、DBeaver)连接,对容器内应用无效。
? 验证步骤:
- 修改
.env后,重启 Sail 容器以加载新配置:./vendor/bin/sail down && ./vendor/bin/sail up -d
- 清除配置缓存(避免旧配置残留):
./vendor/bin/sail artisan config:clear
- 测试数据库连通性:
./vendor/bin/sail artisan tinker >>> DB::connection()->getPdo(); // 若无异常,说明连接成功
? 补充说明:
- 若你未修改
docker-compose.yml中的网络配置(即仍使用 Sail 默认的sail自定义网络),绝对不要使用172.17.0.1(Docker 默认 bridge 网关)——该地址属于bridge网络,而 Sail 容器默认不在该网络中,强行使用会导致连接失败。 -
docker network inspect bridge查到的网关仅适用于显式连接bridge网络的容器,而 Sail 使用的是sail网络(可通过docker network inspect sail查看),其网关通常为172.20.0.1,但服务名mysql始终更可靠、无需硬编码 IP。
✅ 总结:
| 配置项 | 错误值 | 正确值 | 原因 |
|--------|--------|--------|------|
| DB_HOST | 0.0.0.0, localhost, 127.0.0.1 | mysql | 容器间需通过 Docker DNS 解析服务名 |
| DB_PORT | 4306(宿主机端口) | 3306(容器内端口) | 容器网络通信不经过宿主机端口映射 |
完成上述修改后,访问 http://localhost/register 即可正常提交注册表单,用户数据将成功写入 MySQL 容器。

















