TP6 Redis缓存需先安装topthink/think-redis扩展并启用PHP redis扩展，配置中必须显式定义redis store且确保select等参数与实例一致，否则抛ClassNotFoundException。
ThinkPHP 6 的 Redis 缓存驱动怎么配才不报 ClassNotFoundException
直接说结论：TP6 默认不内置 Redis 驱动，必须手动安装 topthink/think-redis 扩展，且 PHP 环境需已启用 redis 扩展（不是 phpredis 别名，是扩展本身）。常见错误是只装了 Composer 包却没开 PHP 扩展，结果一调用 Cache::store('redis')->get(...) 就抛这个异常。
实操步骤：
- 运行
composer require topthink/think-redis - 确认
php -m | grep redis有输出（Linux/macOS）或查看phpinfo()中是否加载了redis模块 - 在
config/cache.php中添加 store 配置，不要只改default，要显式定义redis键
典型配置段（注意 host、port、password 必须与你的 Redis 实例一致）：
'redis' => [
'type' => 'redis',
'host' => '127.0.0.1',
'port' => 6379,
'password' => '',
'select' => 0,
'timeout' => 0,
'expire' => 3600,
],
为什么 Cache::remember() 缓存失效或不命中
根本原因常出在键名生成逻辑和序列化方式上。TP6 的 remember() 底层会把闭包参数、作用域、类名等拼成缓存 key，一旦闭包里用了未声明的变量、或闭包被重复定义（比如在循环中反复 new），key 就会变，导致“写进去读不出”。
立即学习“PHP免费学习笔记（深入）”；
更隐蔽的问题是 Redis 驱动默认用 serialize() 序列化值，而某些对象（如 Query 对象、Request 对象）无法被安全序列化，会静默失败或存入空值。
建议做法：
- 避免在
remember()的闭包里直接操作$this或依赖外部变量，改用明确传参：Cache::remember('user_'.$id, 3600, function () use ($id) { return User::find($id); }) - 对复杂数据，先用
json_encode()转成字符串再缓存，读取时json_decode()，绕过序列化限制 - 检查 Redis 中实际存入的值：
redis-cli get 'cache:user_123'，确认是不是空或乱码
并发场景下 Cache::inc() / Cache::decr() 不准确怎么办
TP6 的 Redis 缓存门面方法（如 inc）底层调用的是 INCR 命令，本身是原子的 —— 但前提是：你用的是同一个 Redis store 实例，且没有跨连接/跨进程干扰。
常见翻车点：
- 多个子应用或命令行任务共用同一组缓存 key，但各自初始化了独立的
Cache实例，连接池未复用 - 开启了
prefix配置但不同环境 prefix 不一致（如开发环境带dev_，生产没配），导致 incr 操作打到不同 key 上 - Redis 配置了
maxmemory且策略为volatile-lru，key 被提前驱逐，incr 后读不到最新值
验证方式：用 redis-cli monitor 实时看命令流，确认 INCR 是否真被发出，以及响应是否为整数。
如何让 Redis 缓存支持多数据库（select 0～15）且互不干扰
TP6 的 Redis 驱动支持 select 参数，但要注意：它只在连接建立时生效，不能动态切换。也就是说，每个 store 配置对应一个固定 db，不能像原生 Redis 客户端那样随时 SELECT 2。
所以想隔离缓存域，正确姿势是定义多个 store：
'redis_user' => [
'type' => 'redis',
'host' => '127.0.0.1',
'port' => 6379,
'select' => 1,
],
'redis_config' => [
'type' => 'redis',
'host' => '127.0.0.1',
'port' => 6379,
'select' => 2,
],
然后分别调用：Cache::store('redis_user')->get('uid_100') 和 Cache::store('redis_config')->get('site_title')。别指望靠一个 store + 动态 select 来实现，TP6 驱动不支持运行时切库。
真正容易被忽略的是连接复用问题：多个 store 配置即使 host/port 相同，TP6 默认也会建多个连接。如果 Redis 连接数快满了，得在配置里加 'persistent' => true 启用长连接，并确保 redis.conf 中 maxclients 足够。
