Laravel事务提交后关联模型加载为空的异常问题排查

可能的原因 #

1. Eloquent模型的内存缓存 #

在事务执行过程中，如果提前触发过关联加载（比如不小心调用了$invoice->lines、打印模型、序列化模型等），此时事务内还未创建对应的InvoiceLine，Eloquent会将空集合缓存到模型的内存属性中。事务提交后，模型不会自动清除这个缓存，直接访问$invoice->lines时会返回缓存的空集合，而非查询数据库的最新数据。

2. InnoDB事务隔离级别的读一致性 #

InnoDB默认使用REPEATABLE READ隔离级别，在这个级别下，事务内的查询会基于快照读。即使事务已经提交，当前PHP进程持有的数据库连接可能还保留着事务内的快照上下文，导致立即查询关联数据时，无法读取到刚提交的InvoiceLine记录。

3. 批量处理时的连接复用问题 #

批量生成300张发票时，Laravel的数据库连接池会复用现有连接。部分连接可能因为事务状态未完全重置，导致后续查询依然使用旧的事务快照，从而读取不到新创建的关联数据。

解决方案 #

• 强制刷新关联数据：不要直接访问缓存的关联属性，改用以下方式强制查询最新数据：

  // 重新从数据库加载整个模型并获取关联
  $freshInvoice = $invoice->fresh();
  $lines = $freshInvoice->lines;
  
  // 或者仅重新加载关联
  $invoice->load('lines');
  $lines = $invoice->lines;
  

• 避免事务内提前触发关联加载：检查事务内的代码逻辑，确保在创建所有InvoiceLine之前，没有任何会触发lines关联加载的操作（比如模型打印、序列化、调用关联属性等）。

• 重置数据库连接（极端场景）：如果是连接复用导致的快照残留，可以在事务提交后重置连接（注意：此操作会影响连接池，仅在必要时使用）：

  DB::disconnect();
  DB::reconnect();
  

• 调整事务隔离级别（可选）：如果业务场景允许，可以将查询的隔离级别改为READ COMMITTED，这样事务提交后就能立即读取到最新数据：

  DB::beginTransaction();
  DB::statement('SET TRANSACTION ISOLATION LEVEL READ COMMITTED');
  // 执行发票创建逻辑
  DB::commit();
  

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