Laravel数组分页报错：调用paginate()出现Call to a member function on array错误

你遇到的Call to a member function paginate() on array错误很常见，原因其实很直白：paginate()是Laravel Eloquent查询构造器或者Collection专属的方法，而你的getAllCategoriesProducts()返回的是普通PHP数组，数组本身没有这个方法。下面给你两种解决方案，从快速修复到性能优化的都有：

方案一：快速修复——将数组转为Collection实现分页 #

如果你暂时不想修改现有的getAllCategoriesProducts()方法，可以先把返回的数组转为Laravel Collection，再用forPage()方法实现分页逻辑。如果需要完整的分页链接（比如视图里的上一页/下一页按钮），还可以手动创建LengthAwarePaginator实例：

1. 基础分页（仅获取当前页数据） #

// 把数组转为Collection，然后获取第1页（默认）的8条数据
$products = collect($this->getAllCategoriesProducts($categoryId))
    ->forPage(request()->get('page', 1), 8);

2. 创建完整分页实例（支持分页链接） #

如果你需要在视图里使用Laravel自带的分页组件，需要手动构建分页器：

use Illuminate\Pagination\LengthAwarePaginator;
use Illuminate\Support\Facades\Request;

$productsArray = $this->getAllCategoriesProducts($categoryId);
$currentPage = LengthAwarePaginator::resolveCurrentPage();
$perPage = 8;

// 截取当前页的数据
$currentPageItems = array_slice($productsArray, ($currentPage - 1) * $perPage, $perPage);

// 创建分页实例
$paginatedProducts = new LengthAwarePaginator(
    $currentPageItems,
    count($productsArray),
    $perPage,
    $currentPage,
    ['path' => Request::url(), 'query' => Request::query()]
);

之后在视图里直接用$paginatedProducts->links()就能渲染分页链接了。

方案二：性能优化——重构查询逻辑（推荐） #

你的getAllCategoriesProducts()方法用了多层嵌套循环，会触发大量数据库查询（典型的N+1问题），数据量变大后性能会很差。更优的做法是先递归获取所有子分类的ID，再一次性查询这些分类下的所有产品并分页：

1. 新增递归获取子分类ID的方法 #

/**
 * 递归获取分类下所有子分类（含自身）的ID
 */
private function getAllSubcategoryIds($catId)
{
    $ids = [$catId];
    // 获取当前分类的直接子分类ID
    $childIds = ProductCategory::where('parent_id', $catId)->pluck('id')->toArray();
    
    foreach ($childIds as $childId) {
        // 递归获取子分类的子分类ID，合并到数组中
        $ids = array_merge($ids, $this->getAllSubcategoryIds($childId));
    }
    
    return $ids;
}

2. 重构产品查询方法 #

根据你的Product和ProductCategory关联关系，分两种情况：

• 如果是多对多关系（产品属于多个分类）：

public function getAllCategoriesProducts($cat_id)
{
    $allCategoryIds = $this->getAllSubcategoryIds($cat_id);
    
    // 直接查询所有关联分类ID在目标数组中的产品，并分页
    return Product::whereHas('categories', function ($query) use ($allCategoryIds) {
        $query->whereIn('product_category_id', $allCategoryIds);
    })->paginate(8);
}

• 如果是一对多关系（产品只属于一个分类，Product表有category_id字段）：

public function getAllCategoriesProducts($cat_id)
{
    $allCategoryIds = $this->getAllSubcategoryIds($cat_id);
    
    return Product::whereIn('category_id', $allCategoryIds)->paginate(8);
}

使用方式 #

现在你直接调用$this->getAllCategoriesProducts($categoryId)就能得到已经分页好的结果，不需要额外调用paginate()了，而且整个过程只需要2次数据库查询（获取分类ID、获取产品），性能比原来的嵌套循环提升很多。

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