Eloquent关联查询优化：获取含角色成员的团队数据（无需循环）

现有4张数据表：

• Users：包含id字段
• Teams：包含id字段
• Roles：包含id字段
• 中间表teams_users：包含team_id、user_id、role_id字段

需求：获取团队数据，每个团队需包含其成员，且每个成员附带在该团队中的角色。当前实现方式是查询团队后循环集合为成员绑定角色并移除角色数据，希望仅通过Eloquent完成，无需循环集合。

已在Team模型中定义以下关联：

public function members() {
        return $this->belongsToMany(User::class, "teams_users", "team_id", "user_id")->withPivot("role_id")->withTimestamps();
    }

public function roles() {
        return $this->belongsToMany(Role::class, "teams_users", "team_id", "role_id")->withPivot("user_id")->withTimestamps();
    }

期望输出格式：

{
    "teams": [
        {
            "id": 1,
            "title": "Awesome team",
            "members": [
                {
                    "id": 1,
                    "name": "Test",
                    "role": {
                        "id": 1,
                        "title": "Admin"
                    }
                }
            ]
        }
    ]
}

1. 给User模型添加角色关联 #

在User模型里新增关联，通过中间表绑定对应的团队角色：

public function teamRole()
{
    return $this->belongsTo(Role::class, 'role_id', 'id');
}

如果你的中间表有自定义模型（比如TeamsUsers），可以追加->using(TeamsUsers::class)，没有的话直接用上面的代码即可。

2. 调整Team模型的members关联 #

修改members方法，预加载用户的团队角色：

public function members()
{
    return $this->belongsToMany(User::class, 'teams_users', 'team_id', 'user_id')
                ->withPivot('role_id')
                ->withTimestamps()
                ->with('teamRole');
}

3. 查询获取目标数据 #

直接预加载members关联，就能拿到带角色信息的完整团队数据：

$teams = Team::with('members')->get();

4. 优化输出格式（可选） #

要是想把teamRole重命名为role，同时隐藏冗余的pivot字段，直接在User模型里配置：

// User模型中
protected $hidden = ['teamRole', 'pivot'];

public function getRoleAttribute()
{
    return $this->teamRole;
}

这样查询出来的每个成员会自动带上role字段，完全不需要手动循环处理集合。

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