Laravel队列监听器中Model::find($id)偶现返回null问题求助

以下是几种常见的原因和对应的解决思路：

• 事务提交时机与队列触发冲突
  如果你触发队列的代码是在数据库事务内部执行的，就可能出现这个问题：主流程创建记录后立即dispatch任务，但事务还没提交，队列进程先跑起来查数据库，自然读不到未提交的记录。等事务提交后再重新执行任务，就能查到了。
  解决办法：要么把dispatch代码移到事务commit之后，要么用Laravel的afterCommit方法延迟触发任务：

  DB::afterCommit(function () use ($id) {
      dispatch(new YourListenerJob($id));
  });
  

• 读写分离的主从同步延迟
  要是你的项目用了数据库读写分离，写操作在主库，队列任务默认从从库读数据，就可能遇到主从同步的时间差——刚写入主库的记录还没同步到从库，队列查从库就返回null，等同步完成后再执行任务就正常了。
  解决办法：让队列任务强制读取主库，比如在查询时指定主库连接：

  $model = Model::on('mysql')->find($id); // 假设主库连接名是mysql，对应config/database.php里的配置
  

• 模型全局作用域或软删除的隐性过滤
  检查你的模型是否加了全局作用域（比如默认只查询status = 1的记录），或者开启了软删除。有可能记录在创建后被临时标记为不符合作用域条件（比如状态被其他操作修改后又改回来），或者被软删除后又恢复了，导致队列执行时刚好命中过滤条件，手动测试时又正常。
  解决办法：临时在队列任务里禁用全局作用域排查：

  $model = Model::withoutGlobalScopes()->find($id);
  

  如果是软删除问题，用withTrashed()确认：

  $model = Model::withTrashed()->find($id);
  

• 缓存机制导致的旧结果命中
  如果你的模型查询加了缓存（比如用了remember()方法），或者数据库开启了查询缓存，有可能某次查询返回null后被缓存了，过段时间缓存过期，重新查询就拿到了正确结果。
  解决办法：排查模型的缓存逻辑，在队列任务中暂时去掉缓存直接查询数据库，或者在查询前清除对应缓存键。

• 数据库隔离级别与快照读的影响
  MariaDB默认的隔离级别是REPEATABLE READ，如果队列任务的事务在主流程事务提交前就开始了，会读取到事务启动时的快照数据，自然看不到未提交的新记录。这种情况和第一个事务问题类似，核心还是要保证队列任务在主事务提交后再执行。

内容的提问来源于stack exchange，提问作者Renny M. Roy