Laravel Eloquent方法链式调用及查询排序报错排查

在Laravel里链式调用Eloquent方法其实非常直观，核心逻辑就是每个查询构建器方法都会返回自身的实例，这样你就能把多个操作依次串起来，直到调用get()、first()这类执行查询的方法为止。

举个实际的例子，比如你想获取状态为「激活」的用户，按创建时间倒序排列，并且只取前10条数据：

$activeUsers = User::where('status', 'active')
                   ->orderBy('created_at', 'desc')
                   ->take(10)
                   ->get();

这里每个方法的作用：

• where('status', 'active')：添加查询条件，筛选出状态激活的用户
• orderBy('created_at', 'desc')：设置排序规则，按创建时间降序
• take(10)：限制返回结果的数量为10条
• get()：执行查询并返回结果集合

除了这些，常用的链式方法还有with()（预加载关联模型，避免N+1查询）、whereIn()、groupBy()、having()等等。另外，当你拿到集合之后，很多集合方法也支持链式调用，比如filter()->sortBy()->pluck()这类组合，只要前一个方法返回的是集合实例就行。

我一眼就看出问题所在啦！你现在的错误是因为用错了方法的调用时机：

sortBy()是Laravel集合（Collection）的方法，而RoadmapCourse::where('user_id', $user_id)返回的是查询构建器（Builder）实例——这时候还没执行数据库查询，根本没有集合，自然调用sortBy()会报错，触发500错误。

给你两个解决方案，推荐用第一个：

方案一：数据库层面排序（推荐，性能更优） #

用查询构建器的orderBy()方法，它会把排序逻辑放到SQL语句里执行，效率更高，而且能和where()直接链式调用：

Route::get('roadmap/{id}', function ($user_id) { 
    return RoadmapCourse::where('user_id', $user_id)
                        ->orderBy('course_id', 'asc') // asc是升序，需要降序就改成desc
                        ->get(); 
});

这样执行后，数据库会直接返回已经按course_id排好序的结果，不会有任何错误。

方案二：集合层面排序（适合特殊场景） #

如果你确实需要在PHP内存里排序，那必须先调用get()获取集合，再调用sortBy()：

Route::get('roadmap/{id}', function ($user_id) { 
    return RoadmapCourse::where('user_id', $user_id)
                        ->get()
                        ->sortBy('course_id'); 
});

不过要注意，这种方式是先把所有符合条件的数据查出来，再在内存里排序，数据量大的时候性能不如数据库层面排序，所以优先选方案一。

简单总结下：查询构建器阶段用orderBy()，拿到集合后才用sortBy()，别搞混啦！

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