ci4 redis缓存需装ext-redis扩展、正确配置host/port/password/database、清空writable/cache/config/并执行php spark cache:clear，save()必须传整数ttl，key须加前缀防冲突且避免敏感信息。
CI4 用 Redis 做缓存，不是配完 cache.php 就能跑通——漏掉 php spark cache:clear 或没清 writable/cache/config/，新配置根本不会生效。
CI4 中启用 Redis 缓存必须装对扩展
必须安装 ext-redis（不是 ext-predis），否则启动时会报 Class 'Redis' not found。Ubuntu/Debian 系统执行：sudo apt-get install php-redis；CentOS/RHEL 用 yum install php-pecl-redis。装完检查 php -m | grep redis，有输出才算成功。Docker 环境下，PHP 容器的 host 配置不能写 localhost，得填 Redis 服务名（如 redis），否则连不上。
app/Config/Cache.php 的关键字段怎么填
只改 $handler = 'redis' 不够，还得确保 $redis 数组里字段有效：
-
'host' => 'redis'（Docker）或'127.0.0.1'（本地） -
'port' => 6379（别漏端口） -
'password' => null（若 Redis 有密码，填字符串，不是'null'） -
'database' => 0（多库隔离时有用，不填默认 0）
改完必须手动删掉 writable/cache/config/ 下所有文件，再运行 php spark cache:clear —— CI4 启动时只读一次配置，不清理就是旧配置在跑。
CacheInterface::save() 的 $ttl 参数不能省
$cache->save('key', 'value', 3600) 第三个参数 $ttl 是整数秒，不传就用配置里的 $defaultTime（默认 300 秒），线上常因此缓存提前失效。注意：
- 传浮点数如
30.5会被截断成30，不报错但逻辑偏移 - 传
0表示“永不过期”，Redis 实际发SET命令，不可靠；文件驱动则依赖文件修改时间，更不准 - 高频查询结果建议显式设
3600或1800，用户 token 类建议精确到900（15 分钟）
缓存键（key）命名容易踩的坑
CI4 对 key 长度有硬限制（Redis 默认 255 字节），空格、控制符会被过滤或截断。更常见的是撞车：比如用户模块和订单模块都用 user_123 当 key，互相覆盖。解决方法：
- 加作用域前缀，如
user:profile:123、order:status:456 - 避免拼接明文敏感信息（如手机号、token 原值）
- 不用动态生成长字符串作 key，优先哈希后截取（如
md5($uid . $params)[0,16]）
线上切记别动 $prefix 配置项——它一改，所有旧 key 全失效，等同于全量缓存击穿。
