Laravel User与Schedule多对多关联查询返回空问题排查

问题根因分类 #

关联功能失效分为两类问题：一是Eloquent多对多关联定义不规范、关联逻辑错误导致查询返回空集合；二是视图层变量、字段名书写错误导致数据无法正常渲染。 #

关联逻辑修复（解决tinker查询返回空集合问题） #

• 修正关联方法命名与外键顺序
  多对多关联因为对应多个关联模型，方法名必须使用复数形式，同时反向关联的外键参数顺序需要和当前模型匹配，错误的方法名、外键顺序会直接导致关联查询为空：

  • User模型关联方法修改：

  // 引入Schedule模型类
  public function schedules()
  {
      return $this->belongsToMany(Schedule::class, 'schedule_user', 'user_id', 'schedule_id');
  }
  

  • Schedule模型反向关联方法修改：

  public function users()
  {
      return $this->belongsToMany(User::class, 'schedule_user', 'schedule_id', 'user_id');
  }
  

  注意：belongsToMany的第三个参数是当前模型在中间表对应的外键名，第四个参数是要关联的模型在中间表对应的外键名，顺序不能写反。

• 校验中间表填充数据
  执行以下tinker命令确认中间表schedule_user存在有效关联数据，排除seeder只填充主表、遗漏中间表关联数据的问题：

  php artisan tinker
  >>> DB::table('schedule_user')->where('user_id', 1)->get();
  

  如果返回空集合，补充编写对应seeder，插入user_id、schedule_id的绑定数据后重新执行填充命令。

• 修正控制器查询逻辑
  关联查询取结果时要调用动态属性（不带括号），不要直接调用关联方法（返回的是查询构造器而非结果集合），推荐使用预加载减少SQL查询次数，示例代码：

  // ScheduleController的index方法
  public function index()
  {
      $user = User::with('schedules')->find(1);
      return view('schedule.index', [
          'schedules' => $user->schedules
      ]);
  }
  

视图层错误修复 #

• 修正变量名拼写错误：遍历schedules集合时，循环变量为$schedule，将所有误写为$jadwak的变量调用统一替换为$schedule。
• 统一字段名大小写：Linux环境下MySQL默认区分字段名大小写，迁移定义的字段为大写开头的Hari、Jam时，视图调用必须和数据库字段名完全一致；建议后续迁移编写时统一使用蛇形小写命名（hari、jam），遵循Laravel默认规范减少大小写匹配问题。

验证步骤 #

修复完成后执行命令清除框架缓存，再重新测试关联查询与页面渲染：

php artisan optimize:clear

缓存清除后重新进入tinker执行Schedule::first()->users，即可正常返回关联用户集合，视图也能正常渲染日程数据。

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