WordPress Cron中wp_mail不触发但PHP mail()可用及HTML邮件问题

问题1：为什么原生mail()可用，但wp_mail在Cron任务里无法触发？ #

wp_mail并不是原生mail()的简单封装，它依赖WordPress的完整运行环境和PHPMailer组件，和原生mail()的运行逻辑有不少差异，常见原因有这几个：

• Cron任务未加载完整的WordPress环境
  如果你是直接写独立PHP脚本作为Cron任务，而不是通过WordPress官方的wp_schedule_event来注册定时任务，很可能没正确引入wp-load.php，导致wp_mail依赖的配置、函数都没初始化。而原生mail()属于PHP核心函数，不需要WP环境就能运行，所以不受影响。

• PHPMailer配置冲突
  很多WordPress站点会通过插件或wp-config.php配置SMTP发送邮件（比如定义WP_SMTP_HOST、WP_SMTP_PORT等参数）。如果Cron运行的环境下这些SMTP配置无法生效（比如服务器防火墙限制了Cron进程的出站请求），或者SMTP服务器拒绝了Cron进程的请求，wp_mail就会发送失败；而原生mail()用的是服务器本地的sendmail服务，不受SMTP配置影响。

• 钩子或插件干扰
  某个主题或插件可能通过wp_mail过滤器、phpmailer_init动作钩子修改了邮件发送逻辑，比如添加了额外的验证、修改了收件人，但这些逻辑在Cron环境下触发了错误（比如依赖用户会话数据，但Cron运行时没有会话），导致wp_mail发送失败。

• 权限差异
  系统级Cron的运行用户（比如www-data或服务器其他用户）和Web请求的运行用户可能不同，导致wp_mail需要读取的PHPMailer文件、日志文件权限不足，从而发送失败；而原生mail()对权限的要求更低，所以能正常运行。

问题1的排查建议 #

1. 改用WordPress官方定时任务API：用wp_schedule_event注册你的任务，确保WP环境完全加载。
2. 暂时禁用SMTP配置：注释掉wp-config.php里的SMTP相关定义，让wp_mail默认使用sendmail，测试是否能发送。
3. 排查插件/主题干扰：暂时禁用所有插件，切换到默认主题（比如Twenty Twenty-Four），再测试Cron任务的wp_mail。
4. 开启调试日志：在wp-config.php里添加define('WP_DEBUG', true); define('WP_DEBUG_LOG', true);，运行Cron后查看wp-content/debug.log里的错误信息，找到wp_mail的具体报错。

问题2：手动访问wp-cron.php能触发邮件，但HTML内容是字符串未解析？ #

这个问题大多是邮件的Content-Type头设置不正确，或者内容被转义导致的，具体原因和解决办法如下：

• 未设置HTML类型的Content-Type头
  wp_mail默认的Content-Type是text/plain，邮件客户端会把所有内容当成纯文本显示，包括HTML标签。你需要手动指定HTML类型的头信息。

• HTML内容被转义
  如果你的邮件内容用了esc_html()、wp_kses()等转义函数，HTML标签会被转换成实体字符（比如<h1>变成<h1>），邮件客户端只能显示成字符串，无法解析成HTML。

• 钩子覆盖了Content-Type
  某些插件或主题可能会强制重置wp_mail的Content-Type为text/plain，即使你自己设置了也会被覆盖。

问题2的解决办法 #

1. 调用wp_mail时直接指定HTML头
   最直接的方式是在调用wp_mail时传递headers参数：

   $to = 'your-recipient@domain.de';
   $subject = 'HTML测试邮件';
   $message = '<h1>您好！</h1><p>这是一封HTML格式的邮件。</p>';
   $headers = array('Content-Type: text/html; charset=UTF-8');
   
   wp_mail($to, $subject, $message, $headers);
   

2. 用钩子临时修改Content-Type
   如果你需要批量发送HTML邮件，可以用钩子临时修改默认类型，发送完成后记得恢复：

   // 设置HTML类型
   add_filter('wp_mail_content_type', function() {
       return 'text/html';
   });
   
   wp_mail($to, $subject, $message);
   
   // 恢复默认的text/plain类型，避免影响其他邮件
   remove_filter('wp_mail_content_type', '__return_false');
   

3. 检查内容是否被转义
   确保你的HTML内容没有经过转义函数处理，如果之前用了转义，去掉相关函数即可。

4. 排查插件干扰
   同样禁用所有插件、切换到默认主题，测试HTML邮件是否能正常解析，确定是否是第三方代码导致的问题。

内容的提问来源于stack exchange，提问作者mxkraus