如何解决wp_insert_post通过Cron Job重复插入同一文章三次的问题？

这种线上独有的重复执行问题我之前也碰到过几次，大概率不是存在性检查的逻辑问题，而是Cron调度、函数触发机制或者并发执行的锅。结合你的情况，我整理几个排查方向和实操解决方案：

1. 先确认Cron任务是否被重复注册 #

线上环境很容易出现重复注册Cron的情况，比如部署脚本重复添加、WP-Cron（如果用WordPress的话）因为服务器配置问题出现任务堆积：

• 登录服务器执行 crontab -l，查看是否有多个完全相同的定时任务条目指向你的RSS导入函数；
• 如果用WordPress的内置Cron，去后台「工具→站点健康→信息→定时任务」里查看，是否有重复的导入事件，或者状态显示「未完成」的堆积任务（有些服务器PHP执行时间过短，任务中途中断会导致系统重复触发）。

2. 验证存在性检查的「唯一标识」是否可靠 #

你说已经做了存在性检查，但可能用来判断重复的字段不够唯一：

• 别用文章标题做判断！标题很容易重复，甚至有些RSS Feed会因为排版问题生成带空格/特殊字符的重复标题；
• 推荐用RSS条目里的 link 字段（文章永久链接）作为唯一标识，这个字段在绝大多数Feed里是绝对唯一的。对应的检查代码可以改成这样：

  // 检查RSS链接对应的文章是否已存在
  $existing_post = get_posts(array(
      'meta_key' => 'rss_source_link',
      'meta_value' => $rss_item['link'],
      'post_type' => 'post',
      'posts_per_page' => 1,
      'post_status' => 'publish,draft' // 别忘了检查草稿状态的文章
  ));
  
  if (empty($existing_post)) {
      // 插入文章的逻辑
      $new_post_id = wp_insert_post($post_args);
      // 一定要把RSS链接存到自定义字段，方便下次检查
      update_post_meta($new_post_id, 'rss_source_link', $rss_item['link']);
  }
  

• 还要注意：如果你的存在性查询用了自定义SQL，要确认是否有字符编码、空格转义的问题，导致本该匹配的记录没匹配到。

3. 给任务加「互斥锁」，防止并行执行 #

线上服务器可能因为负载高、Cron调度延迟，导致前一次导入任务还没执行完，下一次任务又被触发了。这时候数据库事务还没提交，三次检查都会认为文章不存在，从而重复插入：

• 可以用文件锁实现简单的互斥：

  function rss_import_task() {
      $lock_file = '/tmp/rss_import_lock';
      // 锁文件10分钟内有效，防止任务意外中断导致死锁
      if (file_exists($lock_file) && filemtime($lock_file) > time() - 600) {
          error_log("RSS导入任务正在执行，本次触发跳过");
          return;
      }
      // 创建锁文件
      touch($lock_file);
  
      // 这里写你的RSS导入逻辑...
  
      // 任务完成后删除锁文件
      unlink($lock_file);
  }
  

• 如果担心文件锁在多服务器环境失效，可以改用数据库锁：比如在WordPress的 wp_options 表中存一个 rss_import_lock 的选项，执行前更新为「正在执行」并设置过期时间，执行完再改回「空闲」。

4. 加日志！用日志定位问题 #

本地正常线上出问题，日志是最好的排查工具。在存在性检查、插入文章的关键节点打日志：

// 记录当前触发时间和要检查的RSS链接
error_log("[" . date('Y-m-d H:i:s') . "] 开始检查RSS文章：link=" . $rss_item['link']);

$existing_post = get_posts(...);
if (empty($existing_post)) {
    error_log("[" . date('Y-m-d H:i:s') . "] 文章不存在，准备插入：title=" . $rss_item['title']);
    $new_post_id = wp_insert_post($post_args);
    error_log("[" . date('Y-m-d H:i:s') . "] 文章插入成功：ID=" . $new_post_id);
} else {
    error_log("[" . date('Y-m-d H:i:s') . "] 文章已存在：ID=" . $existing_post[0]->ID);
}

然后查看服务器的PHP错误日志（通常在 /var/log/php/ 或网站根目录的 error_log 文件），看看同一小时内是不是有三次相同的检查日志，以及每次检查的结果是什么——这能直接告诉你是检查逻辑没生效，还是任务被触发了三次。

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