latest() 是 Eloquent 查询构造器（Builder）的方法，不能在 get() 返回的 Collection 实例上调用；必须在执行查询前链式调用，且需注意 unique() 和分页无法直接组合使用。

eloquent 中 latest() 方法调用失败的常见原因与正确用法解析：`latest()` 是 eloquent 查询构造器（builder）的方法，不能在 `get()` 返回的 collection 实例上调用；必须在执行查询前链式调用，且需注意 `unique()` 和分页无法直接组合使用。

在 Laravel 开发中，latest() 是一个便捷的查询辅助方法，用于按模型的 created_at 字段（或自定义时间字段）降序排序。但一个常见误区是误将其当作集合（Collection）方法使用——正如以下错误代码所示：

$items = Item::select('*')
    ->orderBy('version','DESC')
    ->get() // ← 此时已执行查询，返回 Illuminate\Database\Eloquent\Collection
    ->unique('name')
    ->latest() // ❌ 报错：Method ...Collection::latest does not exist
    ->paginate(5);

上述写法会在 get() 之后尝试调用 latest()，而此时操作对象已是内存中的 Collection，不再具备 Eloquent Builder 的查询能力，因此抛出 Method does not exist 异常。

✅ 正确做法是：将 latest()（及所有查询条件）置于 get() 或 paginate() 之前，确保它作用于 Builder 实例：

// ✅ 正确：latest() 在 get() 前调用（默认按 created_at DESC）
$items = Item::select('*')
    ->orderBy('version', 'DESC')
    ->latest() // 等价于 ->orderBy('created_at', 'DESC')，可与其它 orderBy 共存（后者优先级更高）
    ->get()
    ->unique('name'); // Collection 层去重（仅适用于小数据量，不支持分页）

⚠️ 但请注意：unique() 是 Collection 方法，无法与 paginate() 共存——因为分页必须由数据库完成（LIMIT + OFFSET），而 unique() 发生在 PHP 内存中，会破坏分页逻辑。若你真正需要的是「每个 name 取最新版本的一条记录」并分页，应改用数据库层去重策略。

推荐的数据库级解决方案

方案 1：使用 DISTINCT ON（PostgreSQL）或模拟（MySQL/SQLite）

// PostgreSQL（原生支持）
$items = Item::select('*')
    ->distinctOn('name')
    ->orderBy('name')
    ->orderByDesc('version')
    ->paginate(5);

方案 2：子查询 + JOIN（全数据库兼容）

适用于获取每组 name 下 version 最大的完整记录：

use Illuminate\Support\Facades\DB;

// 第一步：构建子查询，获取每个 name 对应的最大 version
$maxVersionSub = Item::select('name', DB::raw('MAX(version) as max_version'))
    ->groupBy('name');

// 第二步：主查询 JOIN 子查询，精准匹配完整行
$items = Item::select('items.*')
    ->joinSub($maxVersionSub, 'max_ver', function ($join) {
        $join->on('items.name', '=', 'max_ver.name')
             ->on('items.version', '=', 'max_ver.max_version');
    })
    ->paginate(5);

方案 3：仅需关键字段？用 GROUP BY + 聚合函数（简洁高效）

// 仅需 name 和最新 version，避免 N+1 和复杂 JOIN
$items = Item::select('name', DB::raw('MAX(version) as version'))
    ->groupBy('name')
    ->orderByDesc('version')
    ->paginate(5);

总结与最佳实践

• ✅ latest() / oldest() 只能用于 Eloquent Builder，必须在 get()、first()、paginate() 等执行方法之前调用；
• ❌ 避免在 get() 后链式调用查询类方法（如 latest()、where()、paginate()）；
• ⚠️ unique() 是内存操作，不可替代数据库去重；高并发或大数据量场景下务必使用 GROUP BY、窗口函数或子查询；
• ? 若业务要求“每个 name 的最新一条完整记录”，优先采用 JOIN SUBQUERY 方案，兼顾准确性与性能；
• ? Laravel 9+ 支持 forPage() + cursorPaginate() 配合窗口函数实现更优雅的分页去重，进阶场景可深入探索。

通过理解 Builder 与 Collection 的职责边界，你能写出更健壮、可维护且高性能的 Eloquent 查询。