如何定义Eloquent关联以获取模型的最新归档？

你遇到的问题其实是因为在关联方法里直接调用了first()——Laravel的关联方法需要返回关系实例（比如HasOne），而不是直接执行查询后的结果。当你在hasOne()后面链式调用first()时，返回的是ArchivedModel实例或者null，而框架期望的是能构建查询的关系对象，所以才会抛出addEagerConstraints未定义的异常。

下面给你两种可行的解决方案：

方案1：适配所有Laravel版本的基础写法 #

只需要在关联方法里定义排序规则，不要直接调用first()。因为hasOne关联本身就会取匹配到的第一条记录，结合倒序排序就能拿到最新的归档：

public function mostRecentArchive() {
    return $this->hasOne(ArchivedModel::class, 'original_id', 'id')
        ->orderBy('date_from', 'desc');
}

使用示例：

• 单个模型获取最新归档：$model->mostRecentArchive（自动匹配排序后的第一条，也就是最新的记录）
• 预加载关联批量查询：Model::with('mostRecentArchive')->findOrFail(1)（框架会自动处理批量查询的约束逻辑）

方案2：Laravel 8.42+ 更简洁的写法 #

如果你的Laravel版本在8.42及以上，可以用官方提供的latestOfMany方法，它专门用来获取关联集合中的最新记录，写法更优雅：

public function mostRecentArchive() {
    return $this->latestOfMany(ArchivedModel::class, 'date_from');
}

这个方法内部已经封装了排序和限制逻辑，和基础写法效果完全一致，但代码更精简。

额外提示 #

如果担心模型没有归档时出现报错，可以用PHP 8的null安全操作符或者optional()方法做兼容处理：

// PHP 8+ 写法
echo $model->mostRecentArchive?->date_from;

// 兼容旧PHP版本的写法
echo optional($model->mostRecentArchive)->date_from;

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