DB::select()无法直接分页，需手动查总数与当前页数据并用LengthAwarePaginator构造分页器；复杂SQL分页应拆分为两次查询，避免OFFSET性能问题，游标分页需自行实现。
用 DB::select() 手动查 SQL 时没法直接分页
因为 DB::select() 返回的是纯数组，不带 LengthAwarePaginator 或 CursorPaginator 的能力。你拿到结果后，得自己算偏移、自己截数组、自己塞总数——容易漏总数、错页码、不兼容前端传来的 page 和 per_page 参数。
常见错误现象：DB::select("SELECT * FROM users WHERE status = ?", [$status]) 后硬套 array_slice()，但没查总条数，导致分页器显示“共 0 页”或跳转异常。
- 如果 SQL 简单（无子查询、无 UNION），优先改用 Eloquent 或 Query Builder 的链式分页
- 如果必须手写复杂 SQL（比如含窗口函数、多层嵌套），就用
DB::select()+ 手动构造分页器，但务必单独执行一次COUNT(*)查询 - 注意：MySQL 8+ 的
ROW_NUMBER()不适合直接分页，它不等价于 LIMIT/OFFSET，且无法跳过中间页
复杂 SQL 分页的正确姿势：两次查询 + LengthAwarePaginator
核心是把「查数据」和「查总数」拆开，再用原生结果喂给 Laravel 分页器。别试图在一条 SQL 里塞 LIMIT 和 COUNT(*) —— 大多数场景下它们的 WHERE 条件一致，但执行计划可能完全不同，强行合并反而慢。
示例：分页查带用户等级统计的订单报表
// 1. 先查总数（只 SELECT COUNT(*)，去掉所有字段和 ORDER BY）
$total = DB::select("SELECT COUNT(*) as cnt FROM orders o JOIN users u ON o.user_id = u.id WHERE u.level > ?", [2])[0]->cnt;
<p>// 2. 再查当前页数据（带 LIMIT 和 OFFSET）
$offset = ($page - 1) * $perPage;
$records = DB::select("SELECT o.id, o.amount, u.name FROM orders o JOIN users u ON o.user_id = u.id WHERE u.level > ? ORDER BY o.created_at DESC LIMIT ? OFFSET ?", [2, $perPage, $offset]);</p><p>// 3. 手动构建分页器（注意：第三个参数是当前页码，不是 offset）
$paginator = new LengthAwarePaginator($records, $total, $perPage, $page, [
'path' => request()->url(),
'query' => request()->query(),
]);- 务必检查
$page是否为正整数，否则LengthAwarePaginator构造会报错 -
OFFSET在大数据量时性能差（比如 offset 100000），此时应考虑游标分页或优化索引 - 如果 SQL 含
GROUP BY或聚合，COUNT(*)必须对应重写为COUNT(DISTINCT ...)，否则总数不准
想保留 Query Builder 语法又绕不开复杂 SQL？用 DB::table()->fromRaw()
当 SQL 太长、含变量拼接但又不想全手写字符串时，可以用 fromRaw() 把子查询当表用，再套上 paginate() —— 这样能复用 Laravel 的分页逻辑，包括自动处理 ?page=2、生成链接、响应 JSON 格式。
示例：把带条件聚合的子查询作为主表分页
$paginator = DB::table(DB::raw("(SELECT user_id, COUNT(*) as order_count FROM orders WHERE created_at > '2024-01-01' GROUP BY user_id HAVING COUNT(*) >= 3) as t"))
->join('users', 't.user_id', '=', 'users.id')
->select('users.name', 't.order_count')
->paginate(15);-
fromRaw()中的 SQL 必须有别名（如as t），否则 MySQL 报错 - 子查询里不能有外部参数绑定（如
?），得提前拼进字符串或改用DB::raw()包裹变量 - 这种写法仍会触发两次查询（一次 COUNT，一次 LIMIT），但代码更干净，也兼容
->withQueryString()
游标分页适用于高偏移或实时性要求高的场景
当用户可能翻到第 1000 页，或者数据实时增删频繁时，LIMIT OFFSET 分页会越来越慢，且可能漏/重数据。这时该换游标（cursor）—— 它基于排序字段的值（如 id 或 created_at）做条件过滤，不依赖物理偏移。
注意：Laravel 原生 cursorPaginate() 只支持 Query Builder 和 Eloquent，不支持 DB::select()。所以手写 SQL 时，得自己实现游标逻辑：
- 查下一页：加
WHERE id （假设按 ID 倒序） - 需要客户端传上一页最后一条的
id值，不能传 page 数字 - 游标字段必须有索引，且不能有重复值（否则需组合多个字段，如
(created_at, id)） - 无法跳转任意页（比如直接点“第 50 页”），这是设计取舍，不是 bug
游标分页的健壮性比偏移分页高，但对前端交互和 API 设计要求更高。别为了“看起来高级”而强行用，先确认业务是否真需要。
