Laravel分页未显示或无法工作，请求排查代码问题

核心问题：传递给视图的不是分页实例 #

你控制器中传递给视图的是分页实例的数据集合，而非分页实例本身，导致无法调用links()方法生成分页组件。

错误代码（控制器） #

return view('admin.post.index', ['posts' => $posts['data']['data']]);

这里的$posts['data']['data']是分页实例的data属性（Eloquent集合），而非LengthAwarePaginator分页对象，自然无法触发分页渲染逻辑。

修复方法 #

修改控制器代码，传递完整的分页实例：

// 原错误代码
return view('admin.post.index', ['posts' => $posts['data']['data']]);

// 修改为
return view('admin.post.index', ['posts' => $posts['data']['data']]); // 注：此处实际应为 $posts['data']['data'] 是模型返回的分页实例，若之前变量层级有误，需调整为直接传递模型返回的 $list 对象

次要问题：模型逻辑冗余且未应用过滤条件 #

1. 过滤参数未生效：模型中的$filter参数完全未被使用，导致筛选功能失效。
2. 冗余代码：手动计算$skip和$total毫无必要，paginate()方法会自动处理分页逻辑与总数统计。

修复模型代码 #

public function getAll(array $filter, int $page, int $itemPerPage, string $sort)
{
    $post = $this->query();

    // 应用过滤条件（根据实际表结构调整匹配规则）
    if (!empty($filter['title'])) {
        $post->where('title', 'like', "%{$filter['title']}%");
    }
    if (!empty($filter['slug'])) {
        $post->where('slug', $filter['slug']);
    }
    if (!empty($filter['category_name'])) {
        $post->where('category_name', 'like', "%{$filter['category_name']}%");
    }

    $sort = $sort ?: 'created_at DESC';
    $list = $post->orderByRaw($sort)->paginate($itemPerPage);

    return [
        'total' => $list->total(), // 使用分页实例自带的总数方法
        'data' => $list,
    ];
}

可能的视图配置问题：Tailwind分页视图未正确加载 #

如果你的项目未配置Tailwind风格的分页视图，pagination::tailwind可能无法正常渲染。

修复方案 #

1. 发布Laravel官方分页视图：

php artisan vendor:publish --tag=laravel-pagination

2. 修改视图中的调用路径（若已发布视图）：

<div class="mt-4">
    {{ $posts->links('vendor.pagination.tailwind') }}
</div>

冗余代码清理 #

控制器中手动传递$request->page ??1给模型是多余的，paginate()会自动从请求中获取page参数，可简化控制器与模型的参数列表。

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