FilamentPHP编辑或查看单条记录时为何不执行模型访问器？

问题场景 #

在Laravel模型中定义访问器后，在FilamentPHP资源里使用时，列表页能正常展示访问器生成的内容，但进入编辑或查看单条记录页面时，该字段为空，无法显示内容。

复现步骤（以默认User模型为例）：

1. 在User模型中创建访问器：

public function getTadaAttribute()
{
    return 'tada! '.$this->name;
}

2. 在UserResource.php的表格方法中添加列：

Tables\Columns\TextColumn::make('tada')

3. 同时在表单架构中添加输入框：

Forms\Components\TextInput::make('tada')

操作后，列表页能正常展示tada字段内容，但编辑/查看页该字段为空。

原因分析 #

• Filament的表格列是直接从模型实例中读取属性，只要模型上有对应的访问器，调用$record->tada时就会触发访问器，所以列表页能正常显示。
• 而Filament的表单组件默认会优先从数据库字段或请求数据中读取值，访问器生成的是虚拟属性，不属于数据库字段，也不会自动被表单组件识别加载，所以编辑/查看页无法显示。

解决办法 #

有两种常用的解决方式，根据需求选择：

方式1：手动绑定访问器值并设置只读 #

如果这个字段仅用于展示不需要编辑，直接给表单组件设置只读，手动传入访问器的值，同时设置dehydrated(false)避免提交时尝试写入不存在的数据库字段：

Forms\Components\TextInput::make('tada')
    ->readOnly()
    ->dehydrated(false)
    ->default(fn($record) => $record->tada)

方式2：将访问器属性添加到模型的$appends数组 #

在User模型中把访问器对应的属性名添加到$appends，这样模型序列化时会自动包含这个虚拟属性，Filament表单就能读取到：

class User extends Authenticatable
{
    // ... 其他代码
    protected $appends = ['tada'];

    public function getTadaAttribute()
    {
        return 'tada! '.$this->name;
    }
}

之后表单里直接使用Forms\Components\TextInput::make('tada')就能显示内容，但同样建议加上readOnly()和dehydrated(false)，因为数据库没有这个字段，避免提交表单时出现错误。

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