Laravel 一对多关联插入记录后访问返回空集合问题求解

原因说明 #

问题的核心是Laravel的关联属性缓存机制：当你首次访问$userWeek->userDays动态属性时，Laravel会执行对应的关联查询，将查询结果（此时无数据返回空集合）持久化存储在模型实例的$relations属性中作为缓存。后续你再访问同一个关联属性时，Laravel会直接返回缓存的结果，不会重新发起数据库查询，哪怕你已经在数据库中插入了新的关联数据，缓存也不会自动更新，所以才会出现返回空集合的问题。

解决方案 #

• 方案1：新增数据后主动刷新关联缓存
  在插入数据完成后、返回结果前，调用$userWeek->load('userDays')主动重新查询关联数据更新缓存，或者调用$userWeek->unsetRelation('userDays')清除已有的关联缓存，下一次访问关联属性时就会自动查询最新数据。
• 方案2：避免判断时提前触发关联缓存
  将判断条件从$userWeek->userDays->count() == 0改为$userWeek->userDays()->count() == 0或者更高效的!$userWeek->userDays()->exists()。这里调用的是userDays()关联方法而非动态属性，不会触发关联缓存，插入数据后第一次访问动态属性时就会直接查询最新的完整数据。
• 方案3：（性能优化建议）将循环单条插入改为批量插入，减少数据库IO消耗，优化执行效率。

优化后的完整代码示例：

public function days($userWeek)
{
    // 用关联方法判断，不触发关联缓存
    if (!$userWeek->userDays()->exists()) {
        $date = $this->start;
        $carbon = Carbon::createFromFormat('Y-m-d', $date);
        $insertBatch = [];
        while ($date <= $this->end) {
            $insertBatch[] = [
                'week_id' => $userWeek->id,
                'date' => $date,
            ];
            $date = $carbon->addDay()->format('Y-m-d');
        }
        // 批量插入，仅执行一次SQL
        UserDay::insert($insertBatch);
        // 刷新关联缓存
        $userWeek->load('userDays');
    }
    return $userWeek->userDays;
}

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