分页缓存必须将页码作为缓存键的一部分，否则会导致数据错乱；需对页码等参数做类型转换、白名单校验，并按页粒度精准失效，避免全量清除。
分页缓存必须包含页码作为缓存键的一部分
不把页码嵌入缓存 key，就根本谈不上“联动”。PHP 分页缓存失效或错乱的头号原因，就是用了固定 key（比如 'article_list_cache'）存所有页的数据。用户翻到第 5 页时读到的是第 1 页缓存，这种问题不会报错，只会静默出错。
正确做法是把页码（及每页条数、排序字段等可变参数）拼进 key：
$page = (int)$_GET['page'] ?: 1; $limit = 20; $sort = $_GET['sort'] ?? 'created_at'; $key = 'articles_page_' . $page . '_limit_' . $limit . '_sort_' . $sort;
- 页码必须强制转为整型，防止注入恶意字符串（如
page=1%00abc） - 如果用 Redis 或 APCu，key 长度不宜过长，建议哈希后截取：
substr(md5($key), 0, 16) - 避免直接拼接用户输入的字段名（如
sort=$_GET['sort']），应白名单校验：in_array($sort, ['created_at', 'title', 'id'])
缓存失效要按页粒度清理，不能全删
当某篇文章更新，你不需要清空全部分页缓存——只需要清除它可能出现在哪些页的 key。比如文章 ID=123 按时间倒序排，当前每页 20 条，那它大概率只影响第 1～3 页（取决于总数量和插入位置）。暴力执行 $redis->flushDB() 或删整个目录，会瞬间击穿 DB。
更可行的策略是：写操作后，仅清除受影响的页范围：
立即学习“PHP免费学习笔记（深入）”；
// 假设文章新增/修改后，重新计算它所在页码区间
$affected_pages = range(1, min(5, ceil($total_count / $limit)));
foreach ($affected_pages as $p) {
$key = "articles_page_{$p}_limit_20_sort_created_at";
$redis->del($key);
}- 没必要精确算出哪几页——保守清理前 N 页（如前 5 页）比全清更安全高效
- 如果用文件缓存，注意
unlink()前检查文件是否存在，避免 warning - 不要依赖「缓存过期自动清理」来应对数据变更，尤其高并发场景下，过期窗口会导致脏数据
使用 apcu_cache_info() 或 redis-cli 查 key 是否真命中
你以为缓存生效了，但 apcu_fetch() 返回 false 或 $redis->get($key) 是 null，未必是没存，很可能是 key 拼错了、序列化失败、或被提前淘汰。别靠日志“猜”，得查真实状态。
APCu 可用：
print_r(apcu_cache_info('usercache')); // 看命中率、key 列表Redis 可用命令行确认：
redis-cli --scan --pattern "articles_page_*"
- 如果返回为空，说明 key 根本没生成成功，回头检查拼写、变量作用域、是否漏了
apcu_store() - 如果 key 存在但
get返回空，可能是值为null被存进去了（PHP 中apcu_store($k, null)合法但无意义） - APCu 的
apcu_sma_info()能看内存碎片，满载时新 key 会被踢出，不是 bug，是容量限制
Page number 和 offset 计算别混用，缓存逻辑要统一
有人用 limit $offset, $limit（基于偏移），有人用 limit $limit offset $offset，还有人用游标分页（cursor）。缓存 key 如果同时混用两种逻辑，比如 key 里记的是 page=3，但 SQL 里算成 offset = ($page - 1) * $limit 写错了变成 $page * $limit，结果缓存和 DB 数据永远对不上。
- 统一用「页码 + 每页数」推导 offset，且只在一处做（比如封装成
getPageOffset($page, $limit)） - 缓存 key 中记录的
page必须和传给该函数的$page完全一致，不能一个地方加 1、另一个地方减 1 - 游标分页不适合用「页码」做缓存 key，应改用
cursor_hash或last_id，否则联动失去意义
实际最难的不是写缓存代码，而是让每个开发都记住：页码不是 UI 参数，它是缓存契约的一部分——改页码逻辑，必须同步改 key 构造、失效策略、SQL 计算三处。漏掉任何一环，缓存就从加速器变成定时炸弹。
