Laravel Filament 3.x：关联下拉选择器如何在中间表保存数据？

已通过中间表sub_category_product建立tbl_products与tbl_sub_categories的多对多关联，子分类依赖父分类，目前能正常获取关联数据，但Filament表单中的子分类下拉选择器无法将选中数据保存到中间表。

现有代码 #

Filament Resource表单代码 #

Select::make('category_id')
    ->live()
    ->label('Category')
    ->dehydrated(false)
    ->options(Category::pluck('title','id'))
    ->required(),

Select::make('sub_category_id')
    ->required()
    ->relationship('sub_categories','id') // 使用此代码无法获取子分类列表
    ->multiple()
    ->label('Sub Categories')
    ->placeholder(fn (Forms\Get $get): string => empty($get('category_id')) ? 'First select category' : 'Select an option')
    ->options(function (Forms\Get $get) {
        return SubCategory::where('category_id', $get('category_id'))->pluck('title', 'id');
    })->reactive(),

Product模型关联 #

public function subCategories()
{
    return $this->belongsToMany(SubCategory::class, 'sub_category_product');
}

SubCategory模型关联 #

public function products()
{
    return $this->belongsToMany(Product::class, 'sub_category_product');
}

中间表迁移文件 #

<?php

use App\Models\Product;
use App\Models\SubCategory;
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('sub_category_product', function (Blueprint $table) {
            $table->foreignIdFor(SubCategory::class);
            $table->foreignIdFor(Product::class);
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('sub_category_product');
    }
};

问题分析 #

1. 字段名与关联名不匹配：子分类Select的名称是sub_category_id，但多对多关联的名称是subCategories，Filament需要通过关联名处理多对多关系的保存逻辑，而非单个外键字段。
2. relationship与options冲突：同时使用relationship()和手动options()会导致逻辑冲突，relationship()自动生成选项列表的逻辑被手动设置覆盖，破坏了关联保存的流程。
3. 中间表缺少复合主键：无主键的中间表可能出现重复关联记录，不符合数据库规范。

解决方案 #

1. 修正中间表迁移（可选但推荐） #

给中间表添加复合主键，避免重复关联：

public function up(): void
{
    Schema::create('sub_category_product', function (Blueprint $table) {
        $table->foreignIdFor(SubCategory::class);
        $table->foreignIdFor(Product::class);
        // 添加复合主键
        $table->primary(['sub_category_id', 'product_id']);
    });
}

2. 调整Filament Resource表单代码 #

修改子分类Select的配置，让它正确关联多对多关系并动态过滤选项：

Select::make('category_id')
    ->live()
    ->label('Category')
    ->dehydrated(false)
    ->options(Category::pluck('title','id'))
    ->required(),

Select::make('subCategories') // 使用多对多关联的名称
    ->required()
    ->relationship('subCategories', 'title') // 第二个参数设置为显示的子分类标题字段
    ->multiple()
    ->label('Sub Categories')
    ->placeholder(fn (Forms\Get $get): string => empty($get('category_id')) ? '请先选择分类' : '选择子分类')
    ->options(function (Forms\Get $get) {
        // 根据选中的分类过滤子分类
        return $get('category_id') ? SubCategory::where('category_id', $get('category_id'))->pluck('title', 'id') : [];
    })
    ->live(), // 使用live确保分类选择变化时子分类选项实时更新

关键调整说明 #

• 将Select的名称改为多对多关联名subCategories，Filament会自动处理该关联的保存逻辑。
• relationship()的第二个参数改为title，下拉显示子分类标题而非ID，提升用户体验。
• 移除冲突配置，让options()仅负责动态过滤子分类，关联保存逻辑交由relationship()处理。
• 替换reactive()为live()，确保分类选择变更时，子分类选项实时联动更新。

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