日志分页不能直接用 UserLog::paginate(15)，因其默认执行全表 COUNT(*) 并依赖 OFFSET 跳过大量数据，百万级下响应慢、易拖垮服务；需禁用总数统计、添加 admin_id/created_at 索引或联合索引，并在深度分页时改用游标分页。
用户行为日志表数据量大、查询频次高，直接用 paginate() 默认方式会触发全表 COUNT，在百万级日志下响应明显变慢，甚至拖垮后台。必须绕过默认总数统计、加索引、并考虑游标分页替代方案。
为什么日志分页不能直接用 UserLog::paginate(15)
日志表通常无业务主键约束、字段多、写入密集，paginate() 默认执行的 SELECT COUNT(*) FROM user_log WHERE ... 会全表扫描，尤其带时间范围或用户 ID 过滤时，若没索引，单次查询可能超 2 秒。更糟的是：你翻到第 100 页（OFFSET 1485）时，MySQL 仍要跳过前 1485 条——这不是性能问题，是架构风险。
- 日志表
created_at字段没索引 →WHERE created_at > '2026-05-01'必全表扫 - 复合条件如
WHERE admin_id = 123 AND created_at > '2026-05-01'没联合索引 →COUNT和LIMIT都慢 -
paginate(15)自动读$_GET['page']，但日志页面常需固定每页条数（如始终 20 条），不该允许用户传size干扰审计一致性
禁用总数 + 手动建索引，先稳住响应速度
审计场景中，“总共有多少页”不如“能否快速看最近 100 条”重要。关闭 COUNT 能立竿见影降延迟。
- 用
false关闭总数统计：UserLog::where('admin_id', $id)->order('id desc')->paginate(20, false)，此时只查 20 条数据，不执行COUNT - 确保
admin_id和created_at有单独索引；高频组合查询（如查某人某天操作）必须建联合索引：ALTER TABLE user_log ADD INDEX idx_admin_time (admin_id, created_at); - 若日志表用 MyISAM 引擎，立刻切 InnoDB —— MyISAM 的
COUNT(*)是全表计数，InnoDB 虽也慢但可缓存、支持行锁 - 别信“加了索引就快”：检查
EXPLAIN SELECT * FROM user_log WHERE admin_id = 123 ORDER BY created_at DESC LIMIT 20，确认type是ref或range，不是ALL
深度分页必须换游标，别碰 OFFSET
当运营人员点“下一页”超过 50 次，或导出需求要求拉取第 10000 条之后的数据，LIMIT 10000,20 已不可接受。游标分页用上一页末尾的 id 做起点，恒定走主键索引。
立即学习“PHP免费学习笔记（深入）”；
- 前端传
last_id=12345（非页码），后端写：UserLog::where('id', 'where('admin_id', $id)->order('id desc')->limit(20)->select() - 必须强制
ORDER BY id DESC，且id是自增主键或带唯一索引的时间戳字段；用created_at游标需加id二级排序防重复：ORDER BY created_at DESC, id DESC - 首次请求无
last_id，用ORDER BY id DESC LIMIT 20取头 20 条；后续所有请求都依赖上一批最后一条的id - API 返回结构示例：
['data' => $logs, 'next_cursor' => $logs ? end($logs)['id'] : null]，前端只管传next_cursor，不维护页码
render() 在日志页基本没用，手写分页控件更可控
日志列表通常不需要跳转任意页（比如没人会点“第 372 页”），也不需要 Bootstrap 样式。调用 $logs->render() 反而引入冗余 HTML 和 JS 依赖，还可能因模板未加载 CSS 导致分页按钮错位。
- 直接用
$logs->hasMore()判断是否还有下一页，返回{ "has_more": true, "next_cursor": 12345 } - 前端用按钮控制：“加载更多” → 请求
/api/logs?last_id=12345→ 追加 DOM，不刷新整页 - 若必须服务端渲染分页链接，用
$logs->simple()获取精简对象，再手写<a href="?last_id=12345">下一页</a>，彻底脱离框架样式绑架 - 注意：
$logs->toArray()后$logs->hasMore()就失效了，所有判断必须在转数组前完成
真正卡住日志分页性能的，从来不是 PHP 代码行数，而是那条没走索引的 COUNT，或是第 50000 行的 OFFSET。游标分页看似多传一个参数，却让千万级日志的翻页稳定在 20ms 内——这个 trade-off 值得做。
