You need to enable JavaScript to run this app. Windows上配置MailHog后无法正常接收测试邮件的解决方法
优惠活动
大模型
产品
解决方案
定价
更多

Windows上配置MailHog后无法正常接收测试邮件的解决方法

Windows本地MailHog搭配PHP邮件发送无收件的排查解决步骤
  • 校验php.ini配置的实际生效状态
    • 先确认当前PHP运行环境实际加载的配置文件路径:在对应运行场景下执行php --ini,核对输出的Loaded Configuration File路径,和你手动修改的php.ini文件路径完全一致。Windows下不同的PHP运行场景(CLI命令行、Apache模块、Nginx对应的PHP-CGI)会加载不同路径的php.ini,改错文件是最常见的配置失效原因。
    • 检查sendmail_path的配置格式:这个配置项的值必须是完整指向mhsendmail.exe的绝对可执行文件路径,不能只写存放mhsendmail的目录。比如正确配置为sendmail_path = "D:\Dev\MailHog\mhsendmail.exe",如果只写目录路径,PHP会直接抛出调用错误,根本没法把发邮件的请求传给mhsendmail。
    • 明确配置逻辑:PHP在Windows环境下,只要配置了sendmail_path,就会完全绕过内置的SMTP配置块(也就是同模块下的SMTP、smtp_port参数不会被读取),你之前设置的smtp_port=1025对整个发送流程没有任何实际作用,属于冗余配置,不会对mhsendmail的连接行为产生影响。
  • 手动验证mhsendmail的连通性
    • 打开全新的CMD窗口,直接执行mhsendmail,如果提示“不是内部或外部命令”,说明你之前配置的系统环境变量没有对当前终端、PHP进程生效,需要重启终端和对应的Web/PHP服务进程,让环境变量配置加载完成。
    • 走手动链路发测试邮件:执行echo "测试邮件正文" | mhsendmail test@test.com,执行完成后立刻刷新8025端口的MailHog管理界面,查看这封测试邮件是否能正常出现在收件箱。
    • 如果手动发送都收不到邮件,手动指定mhsendmail的SMTP连接参数再测试:执行echo "带参数的测试邮件" | mhsendmail --smtp-addr=localhost:1025 test@test.com,确认mhsendmail的目标连接端口和本地MailHog的SMTP监听端口完全匹配(mhsendmail默认连接的SMTP地址就是localhost:1025,如果启动MailHog时改过SMTP端口,必须手动指定参数才能匹配)。
  • 排除进程拦截与端口占用问题
    • 检查MailHog的SMTP端口监听状态:执行netstat -ano | findstr ":1025",确认1025端口处于LISTENING状态,排查是否有其他本地程序(比如本地Outlook、其他邮件服务进程)抢占了1025端口导致连接失败。
    • 修改完php.ini后必须重启对应的PHP运行服务:不管是Apache、Nginx还是单独运行的PHP-CGI进程,都必须完整重启才能加载新的配置,不重启服务的情况下所有配置修改都不会生效。
    • 临时关闭Windows Defender、第三方安全软件的实时防护做测试:部分安全软件会拦截mhsendmail.exe的本地出站连接,导致发往1025端口的请求被直接拦截,邮件无法到达MailHog。
  • 定位具体的错误日志
    • 在php.ini里开启邮件发送日志配置:设置mail.log = "C:\php_log\mail.log",复现发送操作后查看日志内容,通常会明确提示可执行文件调用失败、连接超时等具体报错原因。
    • 查看MailHog启动窗口的输出日志:如果mhsendmail的连接请求正常到达MailHog,会在启动MailHog的CMD窗口打印对应的连接记录,如果完全没有相关日志,说明请求根本没有到达MailHog,问题出在前面的mhsendmail调用环节。

内容的提问来源于stack exchange,提问作者giorgi latsabidze

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 04:54:01