Laravel 12中通过hasOneThrough关联连接pivot中间表的实现问询

我最近在Laravel 12项目里搭一个基于角色的多租户系统，遇到个关联查询的小问题想请教下。情况是这样的：每个User在对应的Company下会被分配一个Role，同一个用户在同一家公司只能有一个角色，但可以同时归属多家公司。我理想的查询输出是这样的JSON结构——查用户的时候能关联到公司信息，还能带出对应的角色：

{
  "email": "myuser@gmail.com",
  "company": {
    "id": 1,
    "name": "My Company",
    "role": {
      "id": 2,
      "name": "Admin"
    }
  }
}

我尝试用hasOneThrough来连用户、中间pivot表（存了user_id、company_id和role_id）还有角色表，但一直没搞对关联方式，想问问有没有合适的实现思路？

解决思路和代码示例 #

咱们一步步来理清楚怎么实现：

1. 先确定中间表结构

假设中间表名叫company_user，字段得包含user_id、company_id、role_id，记得给user_id+company_id组合加唯一索引，这样就能保证一个用户在同一家公司只能有一个角色。

2. 定义模型关联

首先在User模型里，先定义和Company的多对多关联，同时把中间表的role_id字段带出来：

// app/Models/User.php
public function companies()
{
    return $this->belongsToMany(Company::class)
        ->withPivot('role_id')
        ->using(CompanyUser::class); // 用自定义中间表模型，方便后续关联角色
}

然后创建自定义的中间表模型CompanyUser，继承Laravel的Pivot类，再定义和Role、Company的关联：

// app/Models/CompanyUser.php
use Illuminate\Database\Eloquent\Relations\Pivot;

class CompanyUser extends Pivot
{
    // 关联到Role模型
    public function role()
    {
        return $this->belongsTo(Role::class);
    }

    // 关联回Company模型，方便后续查询公司信息
    public function company()
    {
        return $this->belongsTo(Company::class);
    }
}

3. 实现目标查询结构

如果是要查询用户在指定公司的信息（比如从请求参数里拿到company_id），可以在User模型里加一个专属的关联方法：

// app/Models/User.php
public function companyWithRole($companyId)
{
    return $this->hasOne(CompanyUser::class, 'user_id')
        ->where('company_id', $companyId)
        ->with(['role', 'company']);
}

之后查询的时候就可以这么用：

// 示例：获取ID为1的用户在ID为2的公司的信息
$user = User::find(1)->load(['companyWithRole' => function ($query) {
    $query->where('company_id', 2);
}]);

// 整理成理想的JSON结构输出
$output = [
    'email' => $user->email,
    'company' => [
        'id' => $user->companyWithRole->company->id,
        'name' => $user->companyWithRole->company->name,
        'role' => [
            'id' => $user->companyWithRole->role->id,
            'name' => $user->companyWithRole->role->name
        ]
    ]
];

return response()->json($output);

要是不想用自定义中间表模型，也可以直接在关联查询里嵌套逻辑，但代码会繁琐不少，还是自定义pivot模型的方式更清晰，后续维护也省心。

备注：内容来源于stack exchange，提问作者Ryan H