Laravel Backpack多对多（BelongsToMany）关联子字段不显示问题

问题背景 #

在User和Role模型使用BelongsTo-HasMany一对多关联时，Laravel Backpack的CRUD可以正常显示子字段，但切换到BelongsToMany多对多关联（通过中间表role_user_table）后，配置的子字段（如User的name）显示为空输入框。

相关代码 #

多对多关联模型配置

User模型：

public function roles(): belongsToMany
{
     return $this->belongsToMany(
            Role::class,
            'role_user_table',
            'user_id',
            'role_id'
      )->using(RoleUser::class);
}

Role模型：

public function users(): belongsToMany
{
     return $this->belongsToMany(
            User::class,
            'role_user_table',
            'role_id',
            'user_id'
      )->using(RoleUser::class);
}

RoleUser中间表模型：

class RoleUser extends Pivot
{
    use CrudTrait;
    use HasFactory;

    protected $table = 'role_user_table';

    public $incrementing = true;

    protected $fillable = [
        'id',
        'user_id',
        'role_id',
    ];

    public function users()
    {
        return $this->belongsTo(User::class, 'user_id');
    }

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

RoleCrudController字段配置（问题版本）：

[
    'label'     => 'User',
    'name'      => 'users',
    'type'      => 'relationship',
    'entity'    => 'users',
    'subfields' => [
        [
            'name'  => 'name', // 此处显示为空输入框
            'label' => 'User name',
        ],
    ]
]

解决方案 #

1. 修正中间表模型的关联方法名 #

中间表的单条记录仅关联一个User和一个Role，因此关联方法名应为单数：

// RoleUser模型中修改
public function user()
{
    return $this->belongsTo(User::class, 'user_id');
}

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

2. 调整CRUD字段配置 #

多对多关联下，Backpack的relationship字段subfields逻辑不适用，需根据需求选择以下配置方式：

方式一：使用select2_multiple选择并显示用户名称

适合在表单中选择关联用户，同时显示用户名称：

[
    'label'     => '用户',
    'name'      => 'users',
    'type'      => 'select2_multiple',
    'entity'    => 'users',
    'attribute' => 'name', // 指定显示User模型的name字段
    'model'     => \App\Models\User::class,
    'pivot'     => true, // 启用多对多中间表支持
]

方式二：使用table类型的relationship展示关联用户详情

适合在CRUD中查看/编辑已关联用户的字段：

[
    'label'     => '用户',
    'name'      => 'users',
    'type'      => 'relationship',
    'entity'    => 'users',
    'type'      => 'table',
    'columns'   => [
        [
            'name'  => 'name',
            'label' => '用户名称',
        ],
        // 可添加其他User字段
    ],
    'pivot'     => true,
]

3. 验证关联数据 #

确保数据库中role_user_table已正确存储user_id和role_id的关联记录，且User模型的name字段有值。

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