Laravel 11中Spatie Media Library图片无法显示问题求助

问题现状 #

• 已执行php artisan storage:link命令，图片成功存入public/storage和storage/app/public文件夹
• 执行过php artisan config:cache和php artisan cache:clear并重新录入数据，问题依旧
• 查阅过Spatie Media Library和Filament官方文档，未解决问题

相关代码与配置 #

1. Filament ProductResource代码

use Filament\Tables\Columns\SpatieMediaLibraryImageColumn;
use Filament\Forms\Components\SpatieMediaLibraryFileUpload;

class ProductResource extends Resource
{
 public static function form(Form $form): Form
    {
        return $form
            ->schema([
                SpatieMediaLibraryFileUpload::make('main_image')
                    ->image()
                    ->required()
                    ->previewable(true)
                    ->collection('main_image')
                    ->columnSpanFull(),
                SpatieMediaLibraryFileUpload::make('additional_images')
                    ->image()
                    ->multiple()
                    ->columnSpanFull()
                    ->collection('additional_images')
                    ->previewable(true)
                    ->maxFiles(3),
            ]);
    }

    public static function table(Table $table): Table
    {
        return $table
            ->columns([
             SpatieMediaLibraryImageColumn::make('main_image')
                ->collection('main_image'),
            ])
    }
}

2. Product模型代码

use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class Product extends Model implements HasMedia
{
    use HasFactory, InteractsWithMedia;
    
    public function registerMediaCollections(): void
    {
        $this->addMediaCollection('main_image')
            ->useDisk('public')
            ->singleFile();

        $this->addMediaCollection('additional_images')
            ->useDisk('public');
    }
}

3. 文件系统配置（config/filesystems.php）

'disks' => [
        'local' => [
            'driver' => 'local',
            'root' => storage_path('app/public'),
            'serve' => true,
            'throw' => false,
        ],
        'products_disk' => [
            'driver' => 'local',
            'root' => public_path('img/products'),
            'url' => env('APP_URL') . '/img/products',
            'visibility' => 'public',
        ],
        'public' => [
            'driver' => 'local',
            'root' => storage_path('app/public'),
            'url' => env('APP_URL').'/storage',
            'visibility' => 'public',
            'throw' => false,
        ],
        's3' => [
            'driver' => 's3',
            'key' => env('AWS_ACCESS_KEY_ID'),
            'secret' => env('AWS_SECRET_ACCESS_KEY'),
            'region' => env('AWS_DEFAULT_REGION'),
            'bucket' => env('AWS_BUCKET'),
            'url' => env('AWS_URL'),
            'endpoint' => env('AWS_ENDPOINT'),
            'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
            'throw' => false,
        ],
    ],

4. 环境变量配置

APP_URL=http://127.0.0.1:8000/

可能的解决方案 #

1. 验证Spatie媒体URL生成

在Tinker中执行以下命令，检查生成的图片URL是否正确：

php artisan tinker

$product = Product::first();
dd($product->getFirstMediaUrl('main_image'));

如果输出URL不是http://127.0.0.1:8000/storage/xxx.jpg格式，说明磁盘配置或媒体集合的URL逻辑存在问题。

2. 显式指定表格列的存储磁盘

修改Filament表格列配置，添加磁盘指定：

SpatieMediaLibraryImageColumn::make('main_image')
    ->collection('main_image')
    ->disk('public'), // 显式绑定public磁盘

3. 重新生成存储软链接

先删除旧链接再重新生成，确保软链接指向正确：

rm public/storage
php artisan storage:link

检查public/storage是否正确指向storage/app/public目录。

4. 修复APP_URL的斜杠问题

将.env中的APP_URL末尾斜杠移除，避免URL拼接错误：

APP_URL=http://127.0.0.1:8000

5. 检查文件权限

确保web服务器用户拥有图片目录的读取权限：

chmod -R 755 storage/app/public
chown -R www-data:www-data storage/app/public

内容的提问来源于stack exchange，提问作者Thariqhat Rama Putra