spatie/laravel-medialibrary调用getMedia()传筛选参数返回空问题

spatie/laravel-medialibrary 扩展包中getMedia()方法的第二个参数不是返回字段白名单，而是媒体资源的过滤条件数组。
当你传入['name', 'original_url']时，扩展包会执行属性匹配逻辑，查找所有name字段值等于字符串name、且original_url字段值等于字符串original_url的媒体资源，自然匹配不到任何数据，最终返回空数组。
getMedia()方法本身没有内置字段筛选返回的能力，你看到的返回字段结构是媒体模型序列化后的默认输出。

• 手动映射字段：获取完整媒体集合后，通过集合的map方法提取需要的字段即可，这是兼容性最高的方案，所有版本都适用：

public function show(Gallery  $gallery)
{
    $images = $gallery->getMedia('default')
        ->map(function ($media) {
            return [
                'name' => $media->name,
                'original_url' => $media->original_url
            ];
        })
        ->values(); // 重置数组键，避免默认以媒体UUID作为键返回
    return response()->json(['data' => $images]);
}

• 调用模型only()方法筛选：如果使用v9及以上版本的扩展包，媒体模型本身继承了Eloquent模型的字段筛选方法，可以直接在映射时调用only()指定返回字段：

$images = $gallery->getMedia('default')
    ->map(fn($media) => $media->only(['name', 'original_url']))
    ->values();

• 统一序列化配置：如果项目中多处需要返回固定结构的媒体字段，可以通过自定义媒体模型、配置默认序列化隐藏/显示字段的方式，不用每次手动映射。

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