本文介绍如何将 Laravel 中多对多关联（如用户-角色）的嵌套集合，转换为每个用户-角色组合独立成行的扁平化结果，支持 Eloquent flatMap 方式和原生 SQL JOIN 两种高效实现方案。

本文介绍如何将 laravel 中多对多关联（如用户-角色）的嵌套集合，转换为每个用户-角色组合独立成行的扁平化结果，支持 eloquent `flatmap` 方式和原生 sql join 两种高效实现方案。

在 Laravel 应用中，当使用 belongsToMany 定义用户与角色的多对多关系后，调用 User::with('roles')->get() 会返回类似以下结构的数据：

[
  {
    "id": 1,
    "name": "Alice",
    "roles": [
      {"id": 1, "name": "admin"},
      {"id": 2, "name": "editor"}
    ]
  }
]

但实际业务中（如导出报表、前端表格渲染或权限明细分析），常需「一用户一行一角色」的扁平格式：

[
  {"id": 1, "name": "Alice", "role_id": 1, "role_name": "admin"},
  {"id": 1, "name": "Alice", "role_id": 2, "role_name": "editor"}
]

✅ 方案一：Eloquent + Collection flatMap()（推荐用于小到中量数据）

利用 Laravel 集合的 flatMap 方法，在内存中将嵌套关系展开。关键点在于：对每个用户，若拥有多个角色，则克隆用户实例并单独绑定一个角色，形成新对象；若无角色，则保留原用户（可按需调整为空跳过）：

use Illuminate\Support\Facades\DB;

$userRoleFlattened = \App\Models\User::with('roles')
    ->get()
    ->flatMap(function ($user) {
        // 若无角色，可返回空集合跳过（更常见）或保留用户
        if ($user->roles->isEmpty()) {
            return collect(); // 跳过无角色用户
        }

        return $user->roles->map(function ($role) use ($user) {
            $flattened = $user->toArray();
            // 合并角色字段，避免嵌套（可选：重命名 role.* 字段避免冲突）
            $roleData = $role->toArray();
            unset($roleData['pivot']); // 移除中间表元数据（如有）
            return array_merge($flattened, [
                'role_id' => $role->id,
                'role_name' => $role->name,
                // 其他角色字段可依需添加
            ]);
        });
    });

⚠️ 注意：此方式在内存中操作，适合结果集较小（如

✅ 方案二：原生 JOIN 查询（高性能首选）

绕过 Eloquent 关系加载，直接通过 SQL JOIN 获取扁平化结果，兼顾性能与可控性：

$userRoleFlattened = DB::table('users')
    ->join('user_role', 'users.id', '=', 'user_role.user_id')
    ->join('roles', 'user_role.role_id', '=', 'roles.id')
    ->select(
        'users.id',
        'users.name',
        'users.email',
        // 用户其他字段...
        'roles.id as role_id',
        'roles.name as role_name',
        'roles.slug as role_slug'
        // 角色其他字段（注意别名避免冲突）
    )
    ->get();

该查询等价于一条 SQL：

SELECT users.*, roles.id AS role_id, roles.name AS role_name 
FROM users 
JOIN user_role ON users.id = user_role.user_id 
JOIN roles ON user_role.role_id = roles.id;

✅ 优势：

• 数据库层完成关联与扁平化，零内存压力；
• 支持 where, orderBy, 分页（paginate()）及索引优化；
• 字段精确控制，无冗余 pivot 或嵌套结构。

? 总结建议

场景	推荐方案	说明
快速原型 / 小数据量 / 需复用模型访问器	flatMap() + Collection	代码简洁，保持 Eloquent 上下文
API 响应 / 导出 / 大数据列表 / 性能敏感	原生 DB::table()->join()	更快、更省内存、更易调试
需要动态条件（如只查启用角色）	JOIN + where 链式调用	在 SQL 层过滤，避免 PHP 层遍历

无论选择哪种方式，最终都可轻松转化为标准 JSON 响应：

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