使用FilamentPHP编辑视图触发SQL 1066表别名重复错误求助

问题原因 #

当使用自定义pivot模型的BelongsToMany关联时，Filament在编辑视图加载关联数据时，会因为pivot模型本身关联了主模型（Machine），导致SQL查询中重复引用中间表machines_power_supplies且未指定唯一别名，触发1066 Not unique table/alias错误。

解决方案 #

方案1：手动处理关联字段（推荐，避免自动查询冲突） #

绕开Filament的relationship()自动关联逻辑，直接操作关联ID数组，手动处理同步和默认值：

在MachineResource的表单定义中替换原Select组件：

use Filament\Forms\Components\Select;

// ...

Select::make('power_supply_ids')
    ->label('Power Supplies')
    // 加载所有可选的Option选项
    ->options(fn () => Option::pluck('name', 'id'))
    ->multiple()
    ->searchable()
    // 编辑时默认选中已关联的选项
    ->default(fn ($record) => $record?->powerSupplies->pluck('id')->toArray())
    // 保存/更新时同步关联关系
    ->afterStateUpdated(function ($state, $record) {
        if ($record) {
            $record->powerSupplies()->sync($state);
        }
    });

同时，确保Machine模型的powerSupplies关联定义正确：

use Illuminate\Database\Eloquent\Relations\BelongsToMany;

class Machine extends Model
{
    // ...

    public function powerSupplies(): BelongsToMany
    {
        return $this->belongsToMany(Option::class, 'machines_power_supplies')
            ->using(MachinePowerSupply::class);
    }
}

方案2：指定关联表别名，修正自动查询逻辑 #

如果希望继续使用Filament的relationship()方法，需要在关联定义中指定唯一别名，并在查询中明确引用：

1. 修改Machine模型的关联定义，添加表别名：

public function powerSupplies(): BelongsToMany
{
    return $this->belongsToMany(Option::class, 'machines_power_supplies', 'machine_id', 'option_id')
        ->using(MachinePowerSupply::class)
        ->as('mps'); // 设置唯一别名
}

2. 在MachineResource的Select组件中，自定义查询逻辑，使用指定的别名避免冲突：

Select::make('powerSupplies')
    ->relationship('powerSupplies', 'name')
    ->multiple()
    ->searchable()
    ->query(fn ($query) => $query
        ->join('machines_power_supplies as mps', 'mps.option_id', '=', 'options.id')
        ->where('mps.machine_id', '=', request()->route('record')?->id)
        ->select('options.*'));

验证 #

修改后，打开编辑视图时，SQL查询会使用唯一的表别名，避免重复引用machines_power_supplies表，即可解决语法错误。

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