Laravel 8 保存Demand记录后如何将关联pivot表的hourly_rate成本返回给前端客户端

核心根因 #

现在接口返回的function、location是Demand模型下两个独立的一对一关联，和Function与Location之间多对多的pivot链路完全是断开的，自然读不到两者组合下存储的hourly_rate值，只要打通这个匹配逻辑就能解决。

分步实操方案 #

1. 预加载关联避免性能问题 #

由于Function模型已经定义了携带hourly_rate的locations()多对多关联，不需要重复写pivot表的原生查询逻辑。拿到刚保存的Demand实例后，先提前加载好需要的关联，防止后续出现N+1查询问题：

// 拿到刚创建完成的Demand实例
$demand = Demand::create($validatedData);
// 预加载所需关联
$demand->load([
    'function:id,name',
    'function.locations:id,name', // 关联定义自带withPivot，会自动带出pivot表的hourly_rate字段
    'location:id,name'
]);

2. 改造DemandResource返回成本值 #

两种改造方式可根据团队代码规范选择：

• 低侵入改造（不改动模型层）：直接在现有Resource的返回结构中新增hourly_rate字段，加安全判断防止空值报错：

  class DemandResource extends JsonResource
  {
      public function toArray($request)
      {
          return [
              'id' => $this->id,
              'function' => new ProfunctionResource($this->whenLoaded('function')),
              'location' => new LocationResource($this->whenLoaded('location')),
              // 新增组合维度的成本值
              'hourly_rate' => $this->when(
                  $this->relationLoaded('function') && $this->relationLoaded('location'),
                  function () {
                      // 从Function关联的Location集合中，精准匹配当前Demand绑定的Location，取出对应的pivot值
                      return $this->function->locations
                          ->where('id', $this->location->id)
                          ->first()
                          ?->pivot->hourly_rate;
                  }
              ),
          ];
      }
  }
  

• 更简洁的封装方案：在Demand模型中新增访问器，把匹配pivot值的逻辑封装在模型层，Resource直接调用即可：

  // Demand模型内新增访问器
  public function getHourlyRateAttribute()
  {
      // 关联不存在时返回null，避免链式调用报错
      if (!$this->function || !$this->location) {
          return null;
      }
      return $this->function->locations()
          ->where('locations.id', $this->location->id)
          ->first()
          ->pivot
          ->hourly_rate;
  }
  

  对应的Resource代码可以简化为直接调用该属性：

  'hourly_rate' => $this->hourly_rate,
  

实际开发避坑提示 #

• 链式调用pivot字段的时候一定要加可选链?->，避免用户提交的function和location组合在pivot表没有对应记录时，直接触发500错误
• 所有数据库查询逻辑尽量放在控制器层完成，不要把查库代码写到Resource内部，不然列表接口返回几十条数据的时候，会连续触发几十次重复查询，性能会明显下降
• 长期运营场景建议在Demand表冗余存储提交时的hourly_rate快照值，毕竟pivot表的成本后续会随业务调整变动，已经生成的需求记录需要保留当时的历史成本，避免后续对账出现差异

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