Laravel Eloquent关联查询失效：PQR表查询未带出关联活动数据

核心问题定位 #

当前关联定义的逻辑和键值匹配完全颠倒，是导致关联数据加载失败的根本原因：

• 按照你现有代码的写法，Eloquent解析出来的belongsTo关联逻辑是：取pqr表上的pqrid字段值，匹配Activities表的主键service字段。这个逻辑和实际表结构完全不匹配：
  1. pqr表本身不存在pqrid字段，所有关联匹配结果自然为空
  2. 实际的表结构关系是：pqr_activities表（Activities模型对应表）存储的pqrid字段，指向pqr表的主键id，外键在从表（pqr_activities）上，因此主表pqr和从表的关联应该使用hasOne/hasMany，而非belongsTo。

具体修正步骤 #

• 第一步：修正PqrGeoreference模型内的activities()关联方法
  根据业务场景选择对应关联类型：如果单个pqr最多对应1条活动记录，使用hasOne；如果单个pqr可对应多条活动记录，改用hasMany即可：

  // 替换原有的activities()方法
  public function activities()
  {
      return $this->hasOne(
          \App\Activities::class,
          'pqrid', // 从表（pqr_activities）上的外键字段
          'id'     // 主表（pqr）上的关联主键
      );
  }
  

  这个关联配置下，Eloquent的with查询默认使用左连接加载关联，没有匹配活动的pqr记录的activities属性会返回null，完全符合“未分配活动的pqr正常返回”的业务要求。
• 第二步：修正Activities模型内的反向关联方法，保证关联逻辑双向一致

  // 替换原有的pqrs()方法
  public function pqr()
  {
      return $this->belongsTo(
          \App\PqrGeoreference::class,
          'pqrid', // 当前Activities表（pqr_activities）上的外键
          'id'     // 关联的主表（pqr）上的主键
      );
  }
  

• 第三步：修正查询中的字段匹配问题
  你当前whereBetween使用的pqrdate字段，在PqrGeoreference模型定义的fillable列表中不存在，对应表内的日期字段为fechapqr，需要确认实际表结构对应的字段名，避免查询数据集偏差。修正后的导出查询可以写为：

  public function collection()
  {
      $datab = PqrGeoreference::with('activities')
          ->whereBetween('fechapqr', [$this->startD, $this->endD])
          ->get();
      return $datab;
  }
  

关联加载的验证方法 #

修正后可以通过以下步骤排查是否生效：

• 临时测试加载逻辑：取单条已知存在关联活动的pqr记录，打印关联属性验证是否加载完成：

  $testRecord = PqrGeoreference::with('activities')->first();
  dd($testRecord->activities);
  

• 排查生成的SQL逻辑：开启Laravel的SQL日志，查看with('activities')生成的关联查询语句，正常的关联查询逻辑应该是从pqr_activities表中筛选pqrid在主表查询结果主键集合内的记录，如果出现反向查询pqr表上pqrid字段的逻辑，说明关联键的配置仍然存在颠倒。
• Maatwebsite导出适配：导出映射字段时使用可选链处理无关联的场景，避免空值报错，例如：

  // 取活动表的accionsuspension字段时的写法
  $row->activities?->accionsuspension
  

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