WordPress 邮件发不出去、注册验证码一直转圈:一次 502 的完整排查与修复

一句话结论

WordPress 注册验证码一直转圈、后台测试邮件报 502|error,多半不是验证码插件的问题,而是 SMTP 连不上,PHP 进程被卡到 110 秒超时强杀。把子比主题里的发件服务器从 smtp.gmail.com 换成 smtp.qq.com:465 后,发信耗时从 110 秒超时变成 0.57 秒成功。

本文要点

  • 现象:前台验证码转圈 + 弹「SSL/https 设置有误」,后台测试邮件 502
  • 根因:SMTP 主机是国内连不稳的 Gmail,每次发送挂满超时被杀
  • 修法:换成 QQ 邮箱 SMTP(465 + SSL + 授权码),后台改配置即可,不用改代码
  • 预防:给 PHPMailer 加 10 秒超时,让故障快速报错而不是拖死整站

适合:用 WordPress + 子比主题、邮件发不出去 / 验证码收不到 / 后台报 502 的站长

这篇文章记录一次真实的排查:从「注册收不到验证码」开始,一路查到 nginx 的 502、php-fpm 的超时强杀,最后定位到一行 SMTP 配置。全过程用到的命令都在文中,遇到同样问题的可以直接照着跑。

症状:验证码一直转圈,后台测试邮件直接 502

先是前台注册。填完邮箱点「获取验证码」,按钮变成「请稍候」就再也不动了,过一会儿右下角弹出一条提示:<b>验证码获取失败,网站疑似 SSL/https 设置有误</b>。

这句话很有误导性——它让人以为是证书或 HTTPS 配置出了问题。实际上网站全站 HTTPS 正常、浏览器没有报警,跟 SSL 一点关系都没有。这只是子比主题对「验证码接口失败」的通用文案,任何原因失败它都这么提示。

接着去后台做官方测试:子比主题设置里的「测试邮件发送」,填入邮箱点发送,按钮直接变成「操作失败」,下面一行红字:

ajax请求错误,请排除插件和子比主题,或通过错误日志进行排查!
错误信息已输出至浏览器控制台,请对照分析。 502|error

到这一步基本可以确定方向了:<b>502 是网关错误,代表 nginx 等不到 PHP 的响应</b>,不是「邮件内容写错了」「邮箱格式不对」这类业务错误。也就是说,PHP 在处理这个请求时崩了,或者卡到超时被杀了。

为什么是 502 而不是「发送失败」?看 php-fpm 的死亡记录

502 的具体来源要去看 PHP 的进程管理日志。宝塔环境下路径是 <code>/www/server/php/82/var/log/php-fpm.log</code>:

tail -20 /www/server/php/82/var/log/php-fpm.log

日志里是这样一行:

[16-Nov-2026 08:35:44] WARNING: [pool www] child 3518349, script '/www/wwwroot/example.com/wp-admin/admin-ajax.php'
(request: "POST /wp-admin/admin-ajax.php") execution timed out (108.032337 sec), terminating
[16-Nov-2026 08:35:44] WARNING: [pool www] child 3518475 exited on signal 15 (SIGTERM) after 110.001562 seconds from start

翻译一下这条链路:

  • 前端点「获取验证码」→ 请求打到 wp-admin/admin-ajax.php
  • PHP 里执行 wp_mail() → PHPMailer 去连 SMTP 服务器
  • 连接一直没成功,也没立刻报错,就那么干等着
  • 超过 php-fpm 的 request_terminate_timeout(110 秒)→ 进程被 SIGTERM 杀掉
  • nginx 拿不到任何响应头 → 返回 502

这里有个容易被忽略的连带影响:<b>被卡住的不是「一封信」,而是一个 PHP 进程</b>。php-fpm 的 worker 数量有限(小内存服务器通常只有十来个),几封邮件同时卡住,其他页面请求就得排队。所以邮件问题往往会表现成「整站变慢」——这也是后面要加超时护栏的原因。

怎么定位到 SMTP?四步、五条命令

从「知道是超时」到「知道超时在等谁」,按下面顺序走,每一步都能排除一类可能。

第一步:确认是上游超时,不是 nginx 配置错

grep -E "502|timed out" /www/wwwlogs/example.com.error.log | tail -5

会看到 <code>upstream timed out (110: Connection timed out) while reading response header from upstream</code> —— 确认 nginx 没毛病,是它在等 PHP。

第二步:确认超时发生在哪个脚本

就是上面 php-fpm 日志里的 <code>script</code> 字段。如果落在 <code>admin-ajax.php</code>,说明是某个 AJAX 动作慢;结合「测试邮件 502」这个现象,基本能锁定发信。

第三步:确认 SMTP 配置到底指向哪里

子比主题的 SMTP 逻辑在 <code>inc/functions/zib-email.php</code>,配置项存在 <code>zibll_options</code> 里,键名是 <code>mail_host</code>、<code>mail_port</code>、<code>mail_name</code>、<code>mail_smtpsecure</code> 等。用 WP-CLI 或一段 PHP 直接读出来:

cd /www/wwwroot/example.com
php -r "require 'wp-load.php'; \$o=get_option('zibll_options');
foreach(['mail_host','mail_port','mail_name','mail_smtpsecure'] as \$k) echo \$k,'=',\$o[\$k],PHP_EOL;"

这次读出来的是:<code>mail_host = smtp.gmail.com</code>、<code>mail_port = 465</code>、<code>mail_smtpsecure = ssl</code>。问题就出在这里。

第四步:测服务器到底能不能连上这个 SMTP 主机

不用装任何工具,bash 自带 <code>/dev/tcp</code> 就能测端口:

for host in smtp.gmail.com smtp.qq.com smtp.163.com; do
  for port in 25 465 587; do
    timeout 4 bash -c "echo > /dev/tcp/$host/$port" 2>/dev/null \
      && echo "$host:$port OK" || echo "$host:$port FAIL"
  done
done

结果非常清楚:<b>所有主机的 25 端口全部 FAIL</b>(腾讯云默认封禁出站 25 端口,这是行业惯例,防垃圾邮件);<b>qq/163 的 465 和 587 全部 OK</b>;<b>gmail 的 465 连不上,587 偶尔通</b>。

第五步:拿到 PHPMailer 的原始错误

最后一步是让 WordPress 自己说清楚错在哪。给个 8 秒上限,避免又卡 110 秒:

timeout 25 php -d max_execution_time=8 -r "
require 'wp-load.php';
add_action('phpmailer_init', function(\$m){ \$m->Timeout = 6; }, 999);
\$t = microtime(true);
var_dump(wp_mail('you@example.com','test','hello'));
echo 'cost ', round(microtime(true)-\$t,1), 's', PHP_EOL;"

输出:<code>SMTP 错误:无法连接 SMTP 主机。Failed to connect to server SMTP 代码:110 其他 SMTP 信息:Connection timed out</code>,耗时 6 秒(被我们设的超时截断)。<b>错误 110 是网络层连接超时</b>,不是账号密码错、不是授权码错——那些会报 535 之类的认证错误。

为什么 Gmail 之前能用,现在就不行了?

这是最容易被误解的一点。很多人以为「墙」是一堵静止的墙,要么通要么不通。实际情况是:<b>对 Google 的干扰是动态的、按 IP 和端口随机的</b>。同一个地址连续测 5 次,可能是这样的结果:

试1 FAIL   试2 FAIL   试3 OK   试4 FAIL   试5 FAIL

五次里通一次。这就解释了两件事:

  • 以前「正常」是碰运气:正好赶上能连通的窗口,邮件几秒就发出去了
  • 现在「不行」不是新故障:赶上阻断窗口,就挂满 110 秒然后 502

服务器日志也能印证这不是偶发。把 php-fpm 里所有「超时强杀」按日期统计,会发现它们成簇出现:

  • 6 月下旬:48 次
  • 9 月下旬:23 次
  • 10 月 26–29 日:127 次(那几天邮件基本瘫痪)
  • 11 月 16 日:2 次(手动测试的那两次)

所以结论不是「Gmail 突然被墙了」,而是<b>这条通道从来就不稳定,只是一直没人真正验证过它是否可靠</b>。国内服务器用 Gmail SMTP 发信,本质上是在赌运气。

怎么彻底修好:换成 QQ 邮箱 SMTP

选 QQ 邮箱的理由很朴素:<b>它是国内网络,不经过任何跨境链路</b>。实测 <code>smtp.qq.com:465</code> 连测五次五次通,没有一次超时。

第一步:拿授权码(不是 QQ 密码)

  1. 浏览器登录 mail.qq.com(建议用网页版,设置项最全)
  2. 右上角「设置」→「账号」(新版叫「账号与安全」→「安全设置」)
  3. 找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服务」→ 开启「SMTP 服务」
  4. 按提示用绑定手机发一条短信验证
  5. 页面会给你一个 16 位字母授权码,复制保存

授权码只在开启时完整显示一次,丢了要重新生成。它不是 QQ 密码,也不要和「独立密码」混为一谈——填错这一项会报 535 认证失败,和本文的超时是两种不同的错。

第二步:在子比主题后台改四项

路径:<b>子比主题设置 → 邮件服务(SMTP)</b>。只需要动这几项:

  • SMTP 主机:smtp.qq.com
  • 端口:465(SSL 加密)。用 587 就把加密方式改成 TLS
  • 发件邮箱:你的QQ号@qq.com
  • 授权码 / 密码:上一步拿到的 16 位字母(不是登录密码)
  • 加密方式保持 SSL,发件人名称可以写成站名(如 Baili Blog)

第三步:立刻验证,别等用户来投诉

先点后台的「测试邮件」,正常的话按钮会直接显示成功、不再转圈。想更硬核一点,用命令行测真实耗时:

timeout 40 php -d max_execution_time=30 -r "
require 'wp-load.php';
\$t = microtime(true);
var_dump(wp_mail('you@gmail.com','[验证] 邮件已修复',date('H:i:s')));
echo 'cost ', round(microtime(true)-\$t,2), 's', PHP_EOL;"

修复前后的对比:

  • 修复前:bool(false),耗时 110 秒后被强杀,前台 502
  • 修复后:bool(true),耗时 0.57 秒

最后还要做一步人肉验证:<b>去前台真实走一遍邮箱注册</b>,看验证码是不是几秒内到。后台测试通过 ≠ 注册链路通过——有些站点的验证码走的是另一个 AJAX 动作,得单独确认。

怎么让下次故障不再拖死整站:给发信加 10 秒超时

换成 QQ 邮箱之后是稳的,但「稳」不等于「永不故障」:授权码会被重置、邮箱会被风控、对方服务器也会抽风。一旦再出现连不上的情况,默认行为还是挂满 110 秒。

解决办法是给 PHPMailer 设一个短超时。用一个 mu-plugin 就能做到,<b>不改主题文件</b>(主题升级会覆盖),放在 <code>wp-content/mu-plugins/</code> 下自动生效:

<?php
/*
Plugin Name: Mail Timeout Guard
Description: 邮件连接超时压到 10 秒,避免卡死 php-fpm 导致 502
*/
add_action('phpmailer_init', function ($phpmailer) {
    $phpmailer->Timeout = 10;
}, 999);

效果:邮件发不出去时 10 秒内就报错,而不是占着进程等两分钟。对用户来说,是「点了马上失败」而不是「转圈等到放弃」;对服务器来说,PHP 进程被占用的时间从 110 秒变成 10 秒,不会连锁拖慢整站。

常见问题 FAQ

Q1:WordPress 后台测试邮件报 502 是什么原因?

502 表示 nginx 等不到 PHP 的响应。最常见是发信时 SMTP 连接卡住,超过 php-fpm 的 110 秒上限被强杀,网关拿不到响应头就返回 502。查 php-fpm 日志能看到 execution timed out 记录。

Q2:前台提示「网站疑似 SSL/https 设置有误」是真的证书问题吗?

不是。这是子比主题对验证码接口失败的统一提示文案,证书正常也会出现。真实原因要看后台测试邮件和服务端日志。

Q3:Gmail SMTP 在国内服务器上能长期用吗?

不建议。实测同一地址连续连接五次只成功一次,属于时通时断。表现是邮件有时几秒发出、有时卡满两分钟,排查起来非常容易被误判成「插件冲突」。

Q4:QQ 邮箱的 SMTP 授权码在哪里获取?

登录 mail.qq.com,进入设置里的账号(或账号与安全)页面,开启 SMTP 服务,按提示用绑定手机发短信验证,即可得到 16 位字母授权码。授权码不是 QQ 登录密码。

Q5:换成 QQ 邮箱发件,还能发到 Gmail 收件箱吗?

能。发件通道和收件地址是两件事:用 QQ 邮箱的服务器发信,收件人填 Gmail 地址,邮件会正常投递到 Gmail。

Q6:为什么邮件发不出去时整个网站都变慢了?

因为卡住的是 PHP 进程而不是单个请求。php-fpm 的 worker 数量有限,几个发信请求各占一个进程等超时,其他页面请求就要排队,表现为全站变慢甚至 502。

Q7:子比主题的 SMTP 设置存在数据库哪里?

存在 wp_options 的 zibll_options 里,键名是 mail_host、mail_port、mail_name、mail_smtpsecure 等,读取逻辑在主题的 inc/functions/zib-email.php。

Q8:改 SMTP 需要改代码或装插件吗?

不需要。子比主题自带 SMTP 功能,后台填主机、端口、账号、授权码即可。注意不要同时启用其他 SMTP 插件,两套配置会互相覆盖。

Q9:加 10 秒超时会影响正常邮件发送吗?

不会。正常发信在 1 秒内完成,10 秒足够。超时只对「连不上」的情况生效,作用是让故障快速失败。


整件事的教训其实不在技术细节上:<b>「之前一直正常」不等于「配置是正确的」</b>。一个靠运气工作的组件,会在某天突然表现为故障,然后让人以为是新出现的问题。能用一条命令验证的东西,就别靠印象判断。

© 版权声明
THE END
喜欢就支持一下吧
点赞14赞赏 分享
评论 抢沙发

请登录后发表评论

    请登录后查看评论内容