FilamentPHP+Spatie媒体库插件：图片无法保存问题求助

问题现象 #

使用FilamentPHP、Spatie媒体库及对应Filament插件在管理面板上传图片时，图片仅临时存放在storage/app/livewire-tmp，Spatie媒体库的media表无新增条目，图片也未保存到目标磁盘designFiles，且无错误日志输出。

相关代码与配置 #

模型代码（OrderItem.php） #

use Illuminate\Database\Eloquent\Model;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class OrderItem extends Model implements HasMedia
{
    use InteractsWithMedia;

    public function registerMediaCollections(): void
    {
        $this->addMediaCollection('designs')
            ->useDisk('designFiles');
    }
}

文件系统配置（filesystem.php） #

'designFiles' => [
    'driver' => 'local',
    'root' => storage_path('app/public/designs'),
    'url' => env('APP_URL') . '/storage/designs',
    'visibility' => 'public',
],

Filament资源代码 #

SpatieMediaLibraryFileUpload::make('design')
    ->collection('designs')
    ->downloadable()
    ->multiple(),

已尝试的无效操作 #

• 在.env的APP_URL中添加端口（使用Laravel Valet）
• 执行php artisan storage:link
• 调试但未发现错误日志

使用版本 #

"php": "^8.2",
"filament/filament": "^3.2",
"filament/spatie-laravel-media-library-plugin": "^3.2",
"laravel/framework": "^11.9",
"spatie/laravel-medialibrary": "^11.8"

更新说明 #

已创建最小复现示例项目，问题仍存在，登录/admin可测试，凭据在database/seeders/DatabaseSeeder.php中。

解决建议 #

• 检查模型填充规则：确保OrderItem模型未将design加入$fillable数组，或直接设置$guarded = []。Spatie媒体库的字段不属于模型数据库字段，无需填充，误加会导致绑定失败。
• 验证媒体库迁移：确认已执行php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations"并运行php artisan migrate，保证media表结构完整。
• 修复目录权限：执行chmod -R 755 storage/，根据服务器环境调整用户组（如chown -R www-data:www-data storage/），确保storage/app/livewire-tmp和目标磁盘目录有读写权限。
• 调整字段与集合匹配：尝试将SpatieMediaLibraryFileUpload::make('design')改为make('designs')，测试字段名与集合名一致时的上传效果。
• 查看日志文件：检查storage/logs/laravel.log，即使本地无错误提示，日志中可能存在未显示的警告或错误信息。
• 测试单文件上传：临时在集合注册中添加->singleFile()，关闭多文件上传功能，验证单文件是否能正常存入目标磁盘。

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