ThinkPHP缓存更新策略详解-ThinkPHP-PHP中文网

缓存更新不及时，八成不是没“写”，而是没“删”或没“写对”：需主动delete/set而非依赖过期；标签名须全小写无特殊字符；apcu/memcached不支持tag；null缓存要改用占位符+短ttl；定时清理需配crontab，且tp7默认驱动为null需显式配置。

thinkphp缓存更新策略详解

缓存更新不及时，八成不是缓存没“写”，而是你没“删”或没“写对”。 ThinkPHP 本身不自动同步数据库与缓存，所有“数据变了但页面还是旧的”问题，根源都在更新路径没闭环——要么漏删、删错键、删错驱动；要么该写新值却只依赖过期；要么标签名大小写一错，Cache::tag('user')->clear() 就形同虚设。

数据库更新后必须主动 `Cache::delete()` 或 `Cache::set()`

靠 expire 等自动过期是懒办法，业务上多数场景要求“改完立刻不可见旧数据”。尤其金额、状态、权限类字段，延迟几秒都可能出问题。

用 Cache::delete('user:detail:123') 最直接，比清整个标签更精准，也避免误伤其他用户缓存
批量更新时优先 Cache::deleteMultiple(['user:123', 'user:456'])，比循环调用 delete() 少开多次连接（Redis 驱动下明显）
如果怕穿透，就别删，改用 Cache::set('user:123', $freshData, 3600) 直接覆盖——但注意：闭包里别漏 return，否则 $freshData 是 null，某些驱动会静默失败
TP6.1+ 支持 Cache::tag('user')->set('profile', $data, 3600)，但必须配 Cache::tag('user')->get('profile') 才能命中；用 cache('profile', ...) 就绕过标签了

`Cache::tag()` 清除失效？先看标签名和驱动是否匹配

标签不是“分类文件夹”，它是靠元数据文件（file 驱动）或 key 前缀（Redis 驱动）映射实现的。拼错一个字符，clear() 就找不到任何键。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

标签名必须全小写、无空格、无冒号：'user_list' ✅，'UserList' ❌，'user:list' ❌
设置带标签的缓存，不能写 cache('key', $data, 3600, ['tag' => 'user'])（无效），必须显式走 Cache::tag('user')->set('key', $data, 3600)
Apcu 和 Memcached 驱动压根不支持 tag()，开了配置也没用；只有 file 和 Redis 可用
Redis 下 Cache::tag('user')->clear() 实际是遍历匹配 think_cache:user:* 前缀的 key，若你自定义了 cache prefix（如 'prefix' => 'api_v2_'），那它清理的是 api_v2_user:*，不是默认前缀

空值缓存怎么写才防穿透？禁用 `null`，用占位符 + 短 TTL

Cache::set('user_999999999', null, 300) 在绝大多数 TP 版本里等于没写——Redis 驱动跳过序列化，file 驱动生成非法文件名，结果就是下次请求照样穿透查库。

统一用可识别的占位符，比如 '__NULL__' 或 json_encode(['_empty' => true])
TTL 必须设短（建议 300 秒以内），否则占位符长期残留，变成“假缓存”阻塞真实数据写入
读取时手动判断：$data = Cache::get('user_123'); if ($data === '__NULL__') { return null; }
所有查询入口（API、命令行、队列任务）必须走同一套逻辑，漏掉一个中间件或手写的 Db::find()，防护就失效

定时清理不是“自动清理”，`php think clear:cache` 要配 crontab 才真生效

ThinkPHP 没内置调度器。config/cache.php 里的 expire 只控制单条缓存生命周期，不会物理删除过期文件或 Redis key。

file 驱动下，过期文件一直堆在 runtime/cache/，得靠 php think clear:cache 或系统级定时任务定期扫
Redis 驱动下，EXPIRE 是后台惰性清理，高并发时 key 可能堆积；php think clear:cache 在 TP6+ 会调用 flushDB（清整个 DB），别和其它服务共用同一个 Redis DB
Linux crontab 示例：0 2 * * * cd /var/www/myapp && php think clear:cache > /dev/null 2>&1 —— 注意必须用绝对路径，且 cd 到项目根目录
别用 php think clear --all 做定时任务，它会连带清 runtime/log/ 和 runtime/route/，可能导致路由缓存丢失，首次访问变慢甚至 404

最易被忽略的一点：所有缓存操作都依赖当前驱动配置是否生效。升级到 TP7 后，默认驱动是 null，config/cache.php 若没显式设 'default' => 'redis'，所有 Cache::get() 都返回 null，但不报错——现象是“缓存像不存在”，实际是根本没启用。