Laravel+Filament中Accessor报Attempt to read property on null问题求助

默认Filament会将图片路径/文件名直接存储到模型字段中，我需要调整为将图片信息存储到独立的files表，模型仅保存关联的file_id。完成配置后，标准FileUpload组件无法显示已保存的图片。我尝试通过Accessor返回图片路径，代码如下：

public function getFileAttribute($value)
{
    $file = File::find((int) $value);

    $path = (string) $file->path;

    // dd($path);

    return $path;
}

但出现报错：

Attempt to read property "path" on null

但取消dd($path)注释后，能看到正确的路径。以下是Guide模型和GuideResource代码，请求排查错误原因：

Guide Model #

class Guide extends Model
{
    // ...

    protected $with = ['file'];

    protected $fillable = [
        'file',
        // ...
    ];

    protected $appends = [
        'file',
    ];

    // ...

    public function file(): BelongsTo
    {
        return $this->belongsTo(File::class);
    }

    // ...

    public function getFileAttribute($value)
    {
        $file = File::find((int) $value);

        $path = (string) $file->path;

        // dd($path);

        return $path;
    }

    public function setFileAttribute($value)
    {
        $file = new File;
        $file->path = $value;
        $file->save();

        $this->attributes['file'] = (string) $file->id;
    }

    // ...
}

GuideResource #

class GuideResource extends Resource
{
    protected static ?string $model = Guide::class;

    protected static ?string $navigationIcon = 'heroicon-o-collection';

    public static function form(Form $form): Form
    {
        return $form->schema([
            Forms\Components\TextInput::make('title')->required(),
            Forms\Components\TextInput::make('description')->required(),
            Forms\Components\FileUpload::make('file')->directory('guide'),
            Checkbox::make('active'),
        ]);
    }

    // ...
}

问题根源 #

1. 属性命名冲突：同时定义了file关联关系、file字段Accessor，且将file加入$appends数组，导致Eloquent加载模型时逻辑混乱。$with = ['file']会提前加载关联，但Accessor又手动执行File::find()，重复查询且易出现空值。
2. 空值未处理：当模型未关联文件时，File::find((int)$value)返回null，直接访问$file->path会触发报错。
3. 字段配置错误：$fillable中的'file'不符合数据库实际字段名，应该是存储关联ID的file_id。

修复步骤 #

1. 修正Guide模型代码

class Guide extends Model
{
    // ...

    // 移除强制预加载关联，按需加载更高效
    protected $with = [];

    protected $fillable = [
        'file_id', // 改为数据库实际存储关联ID的字段名
        // ...
    ];

    // 移除不必要的属性追加，避免逻辑冲突
    protected $appends = [];

    // ...

    public function file(): BelongsTo
    {
        return $this->belongsTo(File::class);
    }

    // 重写Accessor，利用关联关系并处理空值
    public function getFileAttribute()
    {
        // 通过关联获取文件，避免重复查询，空值时返回null
        return $this->file ? (string)$this->file->path : null;
    }

    public function setFileAttribute($value)
    {
        if ($value) {
            // 避免重复创建相同路径的文件
            $file = File::firstOrCreate(['path' => $value]);
            $this->attributes['file_id'] = $file->id;
        } else {
            // 清除文件时置空关联ID
            $this->attributes['file_id'] = null;
        }
    }

    // ...
}

2. 调整FileUpload组件配置

class GuideResource extends Resource
{
    protected static ?string $model = Guide::class;

    protected static ?string $navigationIcon = 'heroicon-o-collection';

    public static function form(Form $form): Form
    {
        return $form->schema([
            Forms\Components\TextInput::make('title')->required(),
            Forms\Components\TextInput::make('description')->required(),
            Forms\Components\FileUpload::make('file')
                ->directory('guide')
                ->disk('public') // 根据实际存储磁盘调整
                ->previewable(), // 开启预览功能
            Checkbox::make('active'),
        ]);
    }

    // ...
}

3. 额外注意事项

• 确保File模型的path字段存储的是文件相对路径（如guide/xxx.jpg），且对应磁盘配置可正常访问该路径。
• 新创建未上传文件的模型时，Accessor会返回null，不会触发报错。

内容的提问来源于stack exchange，提问作者Егор