Laravel 10中Mail模型调用getMediaAttribute()报错求助

错误信息 #

BadMethodCallException: Call to undefined method App\Models\Mail::getMediaAttribute()

相关代码 #

Mail模型 #

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class Mail extends Model implements HasMedia
{
    use HasFactory, SoftDeletes, InteractsWithMedia;

    protected $table = 'mails';

    protected $fillable = [
        'domiciled_id',
        'name',
        'created_at',
        'updated_at',
        'readed_at',
        'deleted_at',
    ];

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

控制器代码 #

use App\Models\Mail;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Crypt;
use Illuminate\Support\Facades\Storage;
use Spatie\MediaLibrary\MediaCollections\Models\Media;

public function index(Request $request)
{
    $mails = Mail::paginate(10);

    $decryptedMails = $mails->map(function ($mail) {
        // 检索'mails'集合的媒体项
        $mediaItems = $mail->getMedia('mails');

        $mail->media = $mediaItems->map(function ($media) {
            // 获取并解密媒体文件内容
            $encryptedContents = Storage::disk($media->disk)->get($media->id . '/' . $media->file_name);
            $decryptedContents = Crypt::decrypt($encryptedContents);

            return [
                'id' => $media->id,
                'file_name' => $media->file_name,
                'mime_type' => $media->mime_type,
                'decrypted_content' => base64_encode($decryptedContents),
                'original_url' => $media->getUrl(),
            ];
        });

        return $mail;
    });

    return response()->json([
        'data' => $decryptedMails,
        'meta' => [
            'total' => $mails->total(),
            'current_page' => $mails->currentPage(),
            'last_page' => $mails->lastPage(),
            'per_page' => $mails->perPage(),
        ],
    ]);
}

问题根源 #

Laravel Eloquent模型遵循属性访问器规则：当你尝试访问模型上未定义的属性（比如$mail->media）时，框架会自动调用对应的get{AttributeName}Attribute()方法（即getMediaAttribute()）。

你在控制器中直接给$mail->media赋值，后续模型实例序列化为JSON时，Laravel会触发该属性的访问逻辑，但Spatie Media Library并未提供这个访问器方法，因此抛出错误。

解决方法 #

方法1：返回数组而非修改原模型实例（推荐） #

避免直接修改Eloquent模型实例的属性，将模型数据转为数组后合并媒体字段：

$decryptedMails = $mails->map(function ($mail) {
    $mediaItems = $mail->getMedia('mails');

    $mediaData = $mediaItems->map(function ($media) {
        $encryptedContents = Storage::disk($media->disk)->get($media->id . '/' . $media->file_name);
        $decryptedContents = Crypt::decrypt($encryptedContents);

        return [
            'id' => $media->id,
            'file_name' => $media->file_name,
            'mime_type' => $media->mime_type,
            'decrypted_content' => base64_encode($decryptedContents),
            'original_url' => $media->getUrl(),
        ];
    });

    // 合并模型属性与媒体数据，返回数组
    return array_merge($mail->toArray(), [
        'media' => $mediaData
    ]);
});

方法2：在模型中定义media属性访问器 #

如果需要保持模型实例结构，可在Mail模型中添加访问器，固定返回mails集合的媒体项：

// 在Mail模型中添加
public function getMediaAttribute()
{
    return $this->getMedia('mails');
}

注意：此方法会让$mail->media始终返回mails集合的内容，若需动态切换集合，优先使用方法1。

额外检查 #

确认Spatie Media Library版本与Laravel 10兼容（推荐v10.x版本），可通过以下命令查看：

composer show spatie/laravel-medialibrary

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