ThinkPHP 6 配置 Redis 缓存驱动必须先安装 topthink/think-redis 扩展包，否则调用 Cache::store('redis') 会直接抛出 ClassNotFoundException 异常，且 config/cache.php 中 type 值必须为全小写'redis'而非'Redis'。
原因分析
ThinkPHP 6 默认只内置 File 和 Array 两种缓存驱动，Redis 驱动需要额外安装扩展包。根据 2026 年 4 月 2 日收录的技术文档，常见错误现象包括'CacheException: Cache handler not exists: redis'或'Connection refused'，根本原因是驱动未注册或 Redis 服务未运行。框架对缓存驱动类型名大小写敏感，写成'Redis'会 fallback 到默认 File 驱动，导致配置看似正确但实际连不上 Redis。PHP 环境需已启用 redis 扩展（通过 php -m | grep redis 验证），仅安装 Composer 包而不开启 PHP 扩展会导致调用 Cache::store('redis')->get() 时抛出异常。
解决方案：安装扩展与验证环境
第一步执行 composer require topthink/think-redis 安装官方扩展包，注意不是 phpredis 或 predis 原生包。第二步验证 PHP 扩展是否加载，Linux/macOS 系统运行 php -m | grep redis 确认有输出，或查看 phpinfo() 中是否加载了 redis 模块。第三步确认 Redis 服务正在运行，默认端口 6379，使用命令 redis-cli ping 返回 PONG 表示服务正常。根据 2026 年 3 月 23 日发布的配置指南，若使用 Docker 或远程 Redis，需检查防火墙和 redis.conf 中 bind 地址是否包含 127.0.0.1 或对应网段。
解决方案：配置文件完整设置
在 config/cache.php 中添加完整的 redis store 配置，不要只改 default。典型配置段如下：'redis' => ['type' => 'redis', 'host' => '127.0.0.1', 'port' => 6379, 'password' => '', 'select' => 0, 'timeout' => 30, 'expire' => 3600]。根据 2026 年 4 月 13 日的技术反馈，select 必须是整数，写成字符串"0"会静默失败；password 为空时不能省略，否则连接可能被拒绝。将 default 值设为'redis'启用 Redis 作为默认缓存驱动。若需持久连接防高并发连接耗尽，设置'persistent' => true。
解决方案：缓存键前缀与过期时间陷阱
ThinkPHP 6 默认给所有缓存 key 加'think:'前缀，在 config/cache.php 的 stores.redis 下加'prefix' => ''可彻底关闭前缀，设为'prefix' => 'myapp:'可自定义前缀。根据 2026 年 3 月 23 日的资料，缓存失效时间传 0 不代表永不过期，实际效果是「立刻过期」，真正永不过期得用 null 或省略第三个参数。正确写法：cache('token', $val, null) 或 cache('token', $val, 3600)，cache('token', $val, 0) 等价于 cache('token', null) 会清掉这个 key。生产环境慎用 null，建议用大值如 31536000（1 年）更可控。
注意事项：生产环境常见踩坑
第一，Cache::get() 返回 null 主因是缓存驱动未生效仍用 file 驱动，需检查 config/cache.php 中 default 是否为'redis'。第二，多项目共用 Redis 时 key 冲突，前缀不是可选项是必选项，建议设为'prefix' => 'shop:'比关掉更安全。第三，用 Tag 标签删除缓存时失效，需在 cache.php 的 redis 配置块中加:'tag_layout' => '%s_%s'启用 tag 功能。第四，session 和 cache 的 redis key 前缀必须区分，避免 FLUSHDB 或 KEYS 操作误伤 session 数据，session 专用前缀配在 config/session.php 的'redis' => ['prefix' => 'sess:']，cache 前缀配在 config/cache.php 的'stores.redis.prefix' => 'cache:'。第五，高并发下 Redis 连接打满，开启'persistent' => true 启用持久连接。
参考来源
来源：ThinkPHP 技术社区 - ThinkPHP6 Redis 缓存驱动配置详解（2026 年 4 月 2 日收录）
来源：PHP 开发者论坛 - ThinkPHP Redis 缓存驱动配置操作指南（2026 年 3 月 23 日发布）
来源：GitHub Issue 讨论 - ThinkPHP 缓存配置与调用技巧（2026 年 4 月 13 日撰）
来源：CSDN 技术博客 - ThinkPHP 缓存机制设置与优化策略（2025 年 11 月 22 日资料）