本文详解 docker 环境下 php 无法通过 mhsendmail 连接 mailhog 的根本原因（本地回环地址误用、二进制兼容性及配置格式问题），并提供可立即生效的修复步骤、验证方法与最佳实践。
本文详解 docker 环境下 php 无法通过 mhsendmail 连接 mailhog 的根本原因（本地回环地址误用、二进制兼容性及配置格式问题），并提供可立即生效的修复步骤、验证方法与最佳实践。
在 Docker 多容器架构中，PHP 应用容器（如 GKapp）与 MailHog 容器需通过自定义桥接网络（app-network）通信。常见错误 error sending mail, dial tcp 127.0.0.1:1025: connection refused 表明：PHP 调用的 mhsendmail 仍在尝试连接本机 127.0.0.1:1025，而非服务名 mailhog:1025 —— 这通常由以下三个关键问题叠加导致：
-
Go 编译的
mhsendmail二进制存在平台/版本兼容性问题：使用go get动态编译生成的二进制可能因 Go 版本（如原文中的 v1.8.3）、CGO 环境或静态链接缺失，在 Alpine/Debian 基础镜像中行为异常，导致--smtp-addr参数被忽略，默认回退至localhost:1025； -
PHP 配置语法不严谨：
sendmail_path = /usr/bin/mhsendmail --smtp-addr mailhog:1025中空格分隔的参数在部分 PHP 版本中解析不稳定；推荐使用等号连接（--smtp-addr=mailhog:1025）并用双引号包裹整个路径，确保参数透传； -
容器网络隔离未被正确利用：虽然
docker-compose.yml已定义app-network，但若mhsendmail未显式指定mailhog:1025或解析失败，仍会 fallback 到127.0.0.1，而该地址在容器内指向自身，非 MailHog。
✅ 推荐修复方案（稳定、轻量、无需 Go 环境）
直接下载官方预编译的静态二进制（兼容性高），并修正 PHP 配置格式：
# 替换原 Dockerfile 中的 mhsendmail 安装段落
RUN curl -LkSso /usr/bin/mhsendmail 'https://github.com/mailhog/mhsendmail/releases/download/v0.2.0/mhsendmail_linux_amd64' && \
chmod +x /usr/bin/mhsendmail && \
echo 'sendmail_path = "/usr/bin/mhsendmail --smtp-addr=mailhog:1025"' > /usr/local/etc/php/conf.d/mhsendmail.ini
? 关键改进说明：
- 使用
-k（跳过 SSL 证书验证）避免下载失败；-S启用错误检查；-o指定输出路径；chmod +x显式赋予执行权限（部分基础镜像默认无）；- 将配置写入
conf.d/下独立.ini文件（优于覆盖主php.ini），且用双引号包裹完整命令，确保--smtp-addr=mailhog:1025作为单个字符串传递；- 移除
go get及cp步骤，彻底规避 Go 构建不确定性。
?️ 验证步骤（进入容器执行）：
# 1. 确认配置已加载 docker exec -it GKapp php -i | grep sendmail_path # 2. 手动测试 mhsendmail 连通性（注意：必须指定 --smtp-addr！） docker exec -it GKapp /usr/bin/mhsendmail --smtp-addr=mailhog:1025 <p>⚠️ <strong>注意事项</strong>：</p>
-
test.eml需为合法 RFC2822 格式邮件（含To:、From:、空行分隔头与正文）； - 若使用
mail()函数，确保email.php中未启用sendmail_path运行时覆盖（如ini_set()）； - MailHog 的
1025端口仅暴露于内部网络（ports:仅用于宿主机访问 Web UI），PHP 容器内必须通过服务名mailhog:1025访问； - 生产环境请改用真实 SMTP 服务，并禁用 MailHog。
✅ 总结：该问题本质是「容器间网络语义」与「工具链参数解析」的错配。采用官方预编译二进制 + 显式等号参数 + 独立 INI 配置，三者结合即可 100% 规避 connection refused，是 Docker-PHP-MailHog 集成的黄金实践。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
