Laravel 10.x：如何为Pivot字段创建访问器实现类型转换？

API 探路者

2026-7-7

解决Laravel中间表Pivot字段JSON转Collection的问题

问题背景

现有两个模型：

User
Place
中间表为roles（对应Pivot关联），包含字段user_id、place_id、type，其中type存储的是类似["manager", "reception"]的JSON字符串。希望通过Place::find(1)->users[0]->pivot->type获取该字段时，直接得到Collection类型，而非字符串，但自定义的访问器未生效。

原因分析

你之前将getTypeAttribute访问器写在User或Place模型中，但默认情况下，Laravel关联返回的pivot是基础Pivot类的实例，而非你的业务模型实例，因此访问器不会被触发。

解决方案：自定义Pivot模型

需要创建自定义的Pivot模型，并在关联中指定使用该模型，具体步骤如下：

1. 创建自定义Pivot模型

在app/Models目录下新建RolePivot.php：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Relations\Pivot;

class RolePivot extends Pivot
{
    // 方式一：使用访问器手动转换
    public function getTypeAttribute($value)
    {
        // 第二个参数true将JSON转为数组，再转为Collection
        return collect(json_decode($value, true));
    }

    // 方式二：更简洁的自动转换（推荐）
    // protected $casts = [
    //     'type' => 'collection',
    // ];
}

2. 在关联方法中指定自定义Pivot模型

修改Place模型的关联方法：

public function users()
{
    return $this->belongsToMany(User::class, 'roles')
                ->using(RolePivot::class)
                ->withPivot('type');
}

同时修改User模型的关联方法：

public function places()
{
    return $this->belongsToMany(Place::class, 'roles')
                ->using(RolePivot::class)
                ->withPivot('type');
}