Filament中SpatieMediaLibraryImageColumn兼容性错误求助

错误信息 #

Declaration of Filament\Tables\Columns\SpatieMediaLibraryImageColumn::applyEagerLoading(Illuminate\Database\Eloquent\Builder|Illuminate\Database\Eloquent\Relations\Relation $query): Illuminate\Database\Eloquent\Builder|Illuminate\Database\Eloquent\Relations\Relation must be compatible with Filament\Tables\Columns\Column::applyEagerLoading(Illuminate\Database\Eloquent\Builder $query): Illuminate\Database\Eloquent\Builder

相关代码 #

表格代码 #

public static function table(Table $table): Table
{
    return $table
        ->columns([
            TextColumn::make('journals_id'),
            TextColumn::make('manuscript_type_id'),
            TextColumn::make('submission_id'),
            TextColumn::make('reference_id'),
            TextColumn::make('edm_reference_id'),
            TextColumn::make('doi'),
            TextColumn::make('title'),

            SpatieMediaLibraryImageColumn::make('manuscripts'),

            TextColumn::make('sub_title'),
            TextColumn::make('created_at')->date()->since(),
            TextColumn::make('updated_at')->date()->since(),
        ])
        ->filters([
            //
        ])
        ->actions([
            Tables\Actions\EditAction::make(),
        ])
        ->bulkActions([
            Tables\Actions\DeleteBulkAction::make(),
        ]);
}

Manuscript模型代码 #

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;
use Spatie\Image\Manipulations;
use Spatie\MediaLibrary\MediaCollections\Models\Media;

class Manuscript extends Model implements HasMedia
{
    use HasFactory, InteractsWithMedia;

    protected $fillable=[
      'journal_id','submission_id','manuscript_type_id',
      'reference_id','edm_reference_id','doi','title','sub_title'
    ];

    public function registerMediaConversions(Media $media = null): void
    {
        $this
            ->addMediaConversion('preview')
            ->fit(Manipulations::FIT_CROP, 300, 300)
            ->nonQueued();
    }
}

解决方案 #

• 版本兼容性修复：该错误源于filament/spatie-media-library-plugin与Filament核心版本不匹配，导致子类方法的参数/返回值声明和父类Column冲突。
  • 先确认你的Filament核心版本（v2或v3），再安装对应版本的插件：
    • Filament v3：执行 composer require filament/spatie-media-library-plugin:"^3.0"
    • Filament v2：执行 composer require filament/spatie-media-library-plugin:"^2.0"
  • 运行 composer update 同步依赖版本。
• 字段名修正：表格中SpatieMediaLibraryImageColumn::make('manuscripts')存在逻辑错误。如果是当前Manuscript模型自身的媒体库，需指向媒体关联字段或指定集合名称：

  // 使用默认媒体集合
  SpatieMediaLibraryImageColumn::make('media')
  // 若有自定义集合（需先在模型中注册对应集合）
  SpatieMediaLibraryImageColumn::make('manuscripts')->collection('manuscripts')
  

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