本文详解 laravel 项目中因 mailhog 主机解析失败导致“connection could not be established”邮件发送异常的根因与修复方法，涵盖 hosts 映射、.env 配置修正、mailhog 服务状态验证及 sail 环境下的正确实践。
本文详解 laravel 项目中因 mailhog 主机解析失败导致“connection could not be established”邮件发送异常的根因与修复方法，涵盖 hosts 映射、.env 配置修正、mailhog 服务状态验证及 sail 环境下的正确实践。
在使用 Laravel Breeze 搭建的项目中，登录与注册功能正常，但「忘记密码」流程触发邮件发送时抛出 Connection could not be established with host "mailhog:1025" 错误，本质是 PHP Mailer 无法将主机名 mailhog 解析为有效 IP 地址——这通常发生在本地开发环境未正确配置 DNS 映射或服务未就绪时。
值得注意的是：你当前使用的是 Laravel Sail（Docker 环境），而答案中建议的 sudo systemctl enable mailhog 是针对宿主机全局安装 MailHog 的操作，这与 Sail 的设计原则相冲突。Laravel Sail 自带 MailHog 容器，应优先通过 Sail 管理，而非手动启停系统级服务。
✅ 正确做法如下：
-
确认 MailHog 容器已启动
运行以下命令检查 Sail 服务状态：./vendor/bin/sail ps
确保输出中包含 mailhog 容器（状态为 Up）。若未运行，启动全部服务：
./vendor/bin/sail up -d
-
修正 .env 中的 MAIL_HOST 配置
在 Sail 环境中，容器间通信通过 Docker 内部网络完成，mailhog 服务名可直接被解析（无需修改系统 hosts）。因此，.env 应保持原样：MAIL_MAILER=smtp MAIL_HOST=mailhog # ✅ 正确：指向 Docker Compose 中定义的服务名 MAIL_PORT=1025 MAIL_USERNAME=null MAIL_PASSWORD=null MAIL_ENCRYPTION=null MAIL_FROM_ADDRESS="hello@example.com" MAIL_FROM_NAME="${APP_NAME}"❌ 不要改为 localhost 或 0.0.0.0 —— 这会导致 PHP 进程（在 laravel.test 容器内）尝试连接宿主机的 1025 端口，而实际 MailHog 运行在独立容器中。
-
验证网络连通性（可选调试）
进入 Laravel 应用容器，手动测试是否能访问 MailHog：./vendor/bin/sail exec laravel.test telnet mailhog 1025
若返回 Connected to mailhog，说明网络通畅；若超时或报错，则需检查 docker-compose.yml 中 mailhog 服务定义是否完整（默认 Sail 已预置，通常无需修改）。
-
刷新配置并重试
修改 .env 后务必清除配置缓存：./vendor/bin/sail artisan config:clear
然后触发密码重置流程，邮件将被投递至 MailHog Web 界面：https://www.php.cn/link/aa3e602dc876a6d7dccff51c07840900（Sail 默认映射端口）。
⚠️ 注意事项：
- 若曾手动安装过系统级 MailHog，请卸载并禁用（sudo systemctl stop mailhog && sudo systemctl disable mailhog），避免端口冲突（如宿主机 1025 被占用）；
- 确保 .env 中无空格、中文引号或隐藏字符；
- 使用 ./vendor/bin/sail artisan tinker 可交互式测试邮件发送：
>>> use Illuminate\Support\Facades\Mail; >>> Mail::raw('Test from Sail', function ($m) { $m->to('test@example.com'); });
总结：该问题核心在于混淆了「宿主机直连」与「Docker 容器间通信」两种模式。Laravel Sail 用户应完全信任 docker-compose.yml 的服务发现机制，坚持使用 MAIL_HOST=mailhog，并始终通过 sail 命令管理服务生命周期——这是最轻量、最可靠、也最符合 Laravel 官方推荐的工作流。
