Laravel 10 多模型关联问题：获取用户-车辆关联的角色名称

1. 修正中间表模型（UserVehicle）的关联定义 #

首先修复UserVehicle模型中错误的车辆关联，并新增角色关联：

// app/Models/UserVehicle.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class UserVehicle extends Model
{
    protected $table = 'user_vehicles';
    public $timestamps = false; // 若表无时间戳字段则添加

    // 关联用户
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }

    // 修正：将原HasOne改为BelongsTo（UserVehicle属于Vehicle）
    public function vehicle(): BelongsTo
    {
        return $this->belongsTo(Vehicle::class);
    }

    // 关联车辆角色
    public function role(): BelongsTo
    {
        return $this->belongsTo(VehicleRole::class, 'vehicle_role_id');
    }
}

2. 更新User与Vehicle的多对多关联 #

在User和Vehicle模型的belongsToMany关联中，指定使用自定义的中间表模型，让pivot对象变为UserVehicle实例：

User模型：

// app/Models/User.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class User extends Model
{
    // ... 其他代码

    public function vehicles(): BelongsToMany
    {
        return $this->belongsToMany(Vehicle::class, 'user_vehicles')
            ->using(UserVehicle::class) // 指定自定义中间表模型
            ->withPivot('vehicle_role_id');
    }
}

Vehicle模型：

// app/Models/Vehicle.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class Vehicle extends Model
{
    // ... 其他代码

    public function users(): BelongsToMany
    {
        return $this->belongsToMany(User::class, 'user_vehicles')
            ->using(UserVehicle::class)
            ->withPivot('vehicle_role_id');
    }

    // 车辆主用户关联
    public function primaryUser(): BelongsTo
    {
        return $this->belongsTo(User::class, 'primary_user');
    }
}

3. 获取角色名称的调用方式 #

预加载关联避免N+1查询：

// 预加载用户车辆及对应角色
$user = User::with('vehicles.pivot.role')->find($userId);

访问角色名称：

// 通过pivot对象直接访问角色名称
echo $user->vehicles[1]->pivot->role->name;

（可选）添加访问器简化调用

若想直接通过$vehicle->role->name获取，可在Vehicle模型中添加访问器（需结合当前用户上下文）：

// Vehicle模型中新增访问器
public function getRoleAttribute()
{
    $currentUser = auth()->user();
    if (!$currentUser) return null;
    
    // 获取当前用户与该车辆的关联角色
    return $this->users()->where('user_id', $currentUser->id)->first()?->pivot->role;
}

调用方式变为：

echo $user->vehicles[1]->role->name;

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