WordPress中24小时延迟发送用户凭证邮件失败问题排查

可能的问题原因及修复方案 #

1. 维护模式导致Cron被禁用 #

WordPress核心及多数维护模式插件会在维护状态下拦截常规Cron执行，包括外部调用wp-cron.php的请求也会被拒绝。

修复：

• 临时关闭维护模式测试：若必须保持维护状态，修改维护规则允许wp-cron.php请求通过。比如编辑.maintenance文件添加例外：

  // 在.maintenance文件中追加
  $allowed = $_SERVER['REQUEST_URI'] === '/wp-cron.php';
  if ($allowed) return;
  

• 改用服务器级Cron替代WP Cron：直接通过系统Cron调用WP CLI执行任务，不受维护模式限制。示例任务：

  0 */1 * * * cd /path/to/your/wordpress && wp cron event run --due-now
  

2. WP Cron事件注册逻辑错误 #

插件中Cron事件的注册时机、时间计算或钩子绑定可能存在问题，导致事件未正确持久化。

检查与修复：

• 确认注册时机：必须在init或plugins_loaded钩子中注册Cron，不要在REST请求处理函数内直接注册（请求结束后事件可能未保存）。
• 修正时间计算：使用WordPress站点时区的时间戳，避免用time()导致时区偏差：

  $timestamp = strtotime('+24 hours', current_time('timestamp'));
  

• 规范事件注册代码：确保用wp_schedule_single_event()正确注册，并绑定处理函数，同时避免重复注册：

  // 注册定时事件的触发逻辑
  add_action('init', function() {
      function schedule_send_credentials($user_id) {
          $timestamp = strtotime('+24 hours', current_time('timestamp'));
          if (!wp_next_scheduled('send_user_credentials', [$user_id])) {
              wp_schedule_single_event($timestamp, 'send_user_credentials', [$user_id]);
          }
      }
  });
  
  // 绑定邮件发送处理函数
  add_action('send_user_credentials', function($user_id) {
      $user = get_user_by('id', $user_id);
      if (!$user) return;
      wp_mail($user->user_email, '账号凭证', '你的账号已通过审核，凭证信息：...');
  });
  

• 用WP CLI验证事件：执行wp cron event list，查看是否存在send_user_credentials事件，以及下次执行时间是否符合预期。

3. 外部调用wp-cron.php无效 #

Node.js调用wp-cron.php时可能因参数、权限或拦截规则导致请求无效。

修复：

• 携带doing_wp_cron参数：WordPress需该参数识别Cron请求，示例请求：

  GET /wp-cron.php?doing_wp_cron=1
  

• 检查服务器拦截规则：查看服务器访问日志，若请求返回403/500错误，修改.htaccess允许wp-cron.php的请求：

  <Files wp-cron.php>
      Order allow,deny
      Allow from all
  </Files>
  

• 确认IP白名单：确保Node.js服务器的IP在目标服务器的防火墙白名单内。

4. 邮件发送失败（并非Cron未执行） #

可能Cron已触发，但邮件因配置或服务器限制未发送，导致误以为任务未执行。

排查：

• 添加执行日志：在邮件处理函数中写入服务器错误日志，确认函数是否被调用：

  add_action('send_user_credentials', function($user_id) {
      error_log('开始处理用户ID ' . $user_id . ' 的凭证发送');
      $user = get_user_by('id', $user_id);
      if (!$user) {
          error_log('用户ID ' . $user_id . ' 不存在');
          return;
      }
      $sent = wp_mail($user->user_email, '账号凭证', '你的账号已激活，凭证是...');
      error_log($sent ? '邮件发送成功给 ' . $user->user_email : '邮件发送失败给 ' . $user->user_email);
  });
  

• 检查邮件配置：使用SMTP插件替代WordPress默认的mail()函数，避免服务器邮件被当成垃圾邮件拦截。

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