如何在Laravel Eloquent模型类中自动处理带关联的模型？

问题原因 #

static::retrieved事件的触发时机是单个模型从数据库取出并完成实例化后立即执行，而预加载（with）的关联数据是在所有模型都实例化完成后，才批量查询并挂载到模型上的。所以在retrieved事件中，你无法获取到预加载的关联数据。

可行解决方案 #

方案一：全局查询after回调（Laravel 8+ 推荐）

在模型的booted方法中添加全局查询作用域，利用查询构建器的after回调——这个回调会在整个查询流程完成（包括预加载关联数据）后执行，此时模型的关联已经完全加载。

public static function booted()
{
    static::addGlobalScope('auto-process-product', function ($query) {
        $query->after(function ($models) {
            // $models 是查询返回的模型集合（单个模型时为长度1的集合）
            $models->each(function (Product $product) {
                $product->check = new ProductCheck($product);
            });
        });
    });
}

添加后，无论你使用Product::with('attributes')->get()还是Product::with('attributes')->find(1)，都会自动执行处理逻辑，且能正常获取预加载的关联数据。

方案二：重写模型的newCollection方法

如果需要对所有返回的模型集合统一处理，可以重写模型的newCollection方法，在集合初始化时完成逻辑处理。如果需要仅在关联加载时执行，可添加关联判断：

public function newCollection(array $models = [])
{
    $collection = parent::newCollection($models);
    
    $collection->each(function (Product $product) {
        // 可选：仅当attributes关联已加载时处理
        if ($product->relationLoaded('attributes')) {
            $product->check = new ProductCheck($product);
        }
    });
    
    return $collection;
}

这个方法会覆盖所有模型集合的创建逻辑，包括get()、all()等方法返回的集合。

方案三：自定义查询范围（按需触发）

如果不需要全局自动处理，而是希望按需触发逻辑，可以定义一个查询范围：

public function scopeWithProductCheck($query)
{
    return $query->with('attributes')->after(function ($models) {
        $models->each(function (Product $product) {
            $product->check = new ProductCheck($product);
        });
    });
}

使用时直接调用：

// 获取带处理逻辑的模型集合
$products = Product::withProductCheck()->get();
// 获取单个带处理逻辑的模型
$product = Product::withProductCheck()->find(1);

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