PHP/Laravel项目出现Call to a member function orderBy() on null错误如何解决

架构老林

2026-9-27

问题排查与解决

核心原因

报错的直接原因是sortOrFilterCollection方法未返回处理后的查询构造器对象，导致$filteredOrSorteredCollection被赋值为null，后续调用orderBy()方法自然触发空对象调用错误。
Laravel的查询构造器是可变对象，你在方法内部对传入的$collection（实际为查询构造器实例）调用where、sort等方法会直接修改原对象，但当前的sortOrFilterCollection没有任何返回语句，PHP方法无显式返回时默认返回null。

修复步骤

给sortOrFilterCollection方法添加返回值，将处理后的查询构造器返回：

public function sortOrFilterCollection($collection, $parseInfo)
{
    foreach($parseInfo as $key => $info){
        switch($key){
            case 'sort':
                $this->sortCollection($collection, $info);
                break;
            case 'search':
                $this->searchCollection($collection, $info);
                break;
                // 后续扩展逻辑可继续在此添加
        }
    }
    // 新增这行，返回处理后的查询构造器实例
    return $collection;
}

可选辅助校验（避免后续同类问题）
可以在paginateResults方法开头添加参数合法性校验，提前拦截异常参数：

private function paginateResults($queryBuilderOrCollection){
    if(!$queryBuilderOrCollection instanceof \Illuminate\Database\Eloquent\Builder){
        throw new \InvalidArgumentException('传入的参数不是有效的查询构造器实例');
    }
    return $this->collection = $queryBuilderOrCollection->orderBy($this->index, $this->sortOrder)->paginate($this->itemsPerPage);
}