Laravel 10/FilamentPHP3中关联州/地区选择字段失效排查

问题描述 #

项目中设置国家/州/地区三级联动选择框，关联geo表。选择国家后州字段可正常加载选项，但选择州后地区字段无法自动填充，日志显示$get('state_id')始终为null。

问题原因及解决方案 #

1. 州选择框未开启实时更新（live模式） #

Filament的$get()方法依赖字段的实时更新机制获取最新值，当前state_id选择框未设置->live()，导致选择州后不会触发表单数据更新，地区选择框无法获取到state_id的最新值。

修复代码：
给state_id选择框添加live()（可按需设置onBlur: true，即失去焦点时触发更新）：

Select::make('state_id')->label('State 987')
    ->live() // 开启实时更新
    ->options(function (callable $get) {
        if (empty($get('country'))) {
            return [];
        }
        return Geo::getByCountry($get('country'))->getByLevel('ADM1')->orderBy('name')->pluck('name', 'id');
    })
    ->helperText('Select state of the country selected above'),

2. 地区选择框的选项生成逻辑错误 #

当前地区选择框直接返回模型集合->get()，而Filament的Select组件需要键值对格式（id => name）的选项；同时字段名region可能不符合数据库绑定逻辑（建议用region_id存储关联ID）。

修复代码：

Select::make('region_id')->label('Region') // 字段名改为region_id更符合关联逻辑
    ->live() // 建议开启实时更新，确保响应州选择的变化
    ->options(function (callable $get) {
        if (empty($get('state_id'))) {
            return [];
        }

        // 返回id => name格式的选项数组
        return Geo::getByCountry($get('country'))
            ->getParentId($get('state_id'))
            ->getByLevel('ADM2')
            ->orderBy('name')
            ->pluck('name', 'id');
    })
    ->helperText('Select region of the state selected above'),

3. 确认Geo模型查询作用域的正确性 #

检查getByCountry()、getParentId()、getByLevel()这些查询作用域的实现逻辑，确保：

• getParentId($state_id)是根据parent_id = $state_id筛选数据
• getByLevel('ADM2')正确过滤出地区级别的数据
  避免因查询逻辑错误导致无数据返回。

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