thinkphp8缓存驱动配置失败时，cache::get()返回null、set()无报错却未写入redis或抛出class 'redis' not found，根本原因是php未启用redis扩展，需执行php -m | grep redis验证，确认php.ini中extension=redis（linux/macos）或extension=php_redis.dll（windows）已启用并重启php-fpm与web服务器。
ThinkPHP8缓存驱动配置失败时，Cache::get()始终返回null、set()无报错却写不进Redis、或直接抛出Class 'Redis' not found，这类问题往往卡在环境层而非代码逻辑——你改了十遍config/cache.php，其实PHP根本没加载扩展。
PHP扩展未启用或名称错误
运行php -m | grep redis，若无输出，说明redis扩展未启用；Windows下检查php.ini中extension=php_redis.dll是否被注释，Linux/macOS确认extension=redis存在且未拼错为phpredis或memcache。
重启PHP-FPM和Web服务器（Apache/Nginx）——【CLI与Web环境的php.ini常不同，只改CLI配置而没重启FPM会导致测试成功但网页失效】。
Memcached驱动报Class 'Memcached' not found？运行php -r "new Memcached();"验证：若报错，说明装的是老版memcache（类名Memcache），而非新版memcached（类名Memcached）。
缓存驱动未真正切换
检查config/cache.php中'default' => 'redis'是否小写，不能写成'Redis'或'REDIS'。
确认stores.redis配置块完整：host、port、select（必须是整数，写"0"会静默失败）、password（空密码也必须显式写''）。
用命令行快速验证驱动是否生效：php -r "var_dump(cache('test', 'ok', 10));" → 再执行php -r "var_dump(cache('test'));"，两次都返回'ok'才算通。
Docker或云环境网络不通
第一步：在ThinkPHP容器内执行telnet 127.0.0.1 6379（Redis）或nc -zv 127.0.0.1 11211（Memcached）；不通就别调代码。
第二步：Docker场景下，host => 'localhost'是致命错误——它连的是容器自身127.0.0.1，不是宿主机或另一容器；应改为host => 'host.docker.internal'（Mac/Win）或对应容器服务名（如redis）。
第三步：云服务器需检查安全组是否放行6379/11211端口，SELinux是否拦截连接，Redis是否绑定127.0.0.1而非0.0.0.0。
缓存值含不可序列化数据
方法一：Redis驱动配置'serialize' => 'json'，强制用JSON序列化，自动跳过Closure、PDO、resource等类型。
方法二：File驱动需重写serialize()方法，在app/common/cache/SerializableFile.php中预判is_object($data) || is_resource($data)，转为null或字符串标记。
注意：把Request对象、含闭包的回调数组、第三方SDK client实例直接塞进缓存，必然触发Serialization of 'Closure' is not allowed。
缓存写入语义误用
第一步：cache('key', $val, 0) → 等同于立即删除，不是永不过期。
第二步：cache('key', $val, null) → Redis中不设TTL，依赖内存淘汰策略清理。
第三步：cache('key', $val) → 使用配置中stores.redis.expire默认值，若未设则可能为0导致写入即失。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
