Laravel Redis缓存配置与加速技巧

Laravel 中启用 Redis 缓存远不止设置 `CACHE_DRIVER=redis` 这么简单——90% 的连接失败、缓存不生效或序列化错乱问题，根源在于 `config/database.php` 与 `config/cache.php` 配置未严格对齐，且遗漏了关键的 `php artisan config:clear` 清理操作；从 Redis 主机地址、密码字段命名、连接名一致性，到序列化方式统一、连接池配置及实时验证技巧，本文直击生产环境中最易踩坑的细节，帮你真正让 Redis 缓存“跑起来、稳得住、快得见”。

直接说结论：CACHE_DRIVER=redis只是开关，真正连不上、缓存不生效、序列化错乱，90%是因为 config/database.php 和 config/cache.php 两处配置没对齐，且漏了 php artisan config:clear。

config/database.php 的 redis 配置必须和 .env 对得上

很多项目改了 REDIS_HOST 和 REDIS_PORT，Cache::get() 还是连 127.0.0.1:6379——不是环境变量没读到，而是 Laravel 启动时从 config/database.php 的 'redis' => ['default' => [...]] 里取连接参数，.env 只是被 env() 函数调用，不会自动映射。

• config/database.php 中 'redis.default.host' 必须等于 env('REDIS_HOST')，不能写死 'localhost'（Docker 内访问宿主要用 host.docker.internal）
• password 字段名必须是 'password'，不是 'REDIS_PASSWORD'；若用空密码，要设为 null，不能留空字符串
• 如果用了云 Redis（如阿里云），端口可能是 6380 或带代理，redis-cli -h xxx -p xxx ping 能通，但 Laravel 报 Connection refused，大概率是这里配错了

config/cache.php 的 redis store 要指向正确的 connection 名

Laravel 缓存组件复用的是数据库配置里的 redis 连接定义，不是独立一套。默认情况下 config/cache.php 里 'stores.redis.connection' 是 'default'，但如果在 .env 里写了 CACHE_REDIS_CONNECTION=cache，而 config/database.php 里没有 'cache' 这个键，就会静默失败。

• 确认 config/cache.php 中 'default' => 'redis'，且 'stores.redis.connection' 值和 config/database.php 中 redis 子数组的 key 一致（比如 'default' 或 'cache'）
• 别依赖 php artisan cache:clear 清 Redis——它只清 config/cache.php 指定的 connection，不是全库 flush
• 验证是否真连上了：跑 php artisan tinker，执行 Cache::store('redis')->put('test', 'ok', 60)，再 Cache::store('redis')->get('test')，返回 'ok' 才算通

序列化不一致会导致 get() 总是 null

Cache::get() 返回 null 不一定代表没命中，也可能是写入和读取用了不同序列化方式。phpredis 默认用 igbinary（如果启用了），predis 默认用 serialize()，两者不兼容。

• 运行 php --ri redis 看 phpredis 是否已加载；没加载就 fallback 到 predis，但行为不一致
• 统一序列化方式：在 config/cache.php 的 'stores.redis.options' 下加 'serializer' => 'php'
• 缓存 Eloquent 模型时，remember() 默认走 PHP 原生 serialize()，但若模型里有闭包、资源句柄或动态属性（如 $appends），建议先 toArray() 再缓存

别让缓存“看起来开了”，其实根本没 hit

开了 Redis 缓存，页面速度却没提升？因为 Laravel 不会自动缓存你写的任何逻辑——view、route、config 的缓存要单独开，业务数据得你自己调 Cache::remember() 或 Cache::store('redis')->get()。

• 用 redis-cli monitor 实时看有没有 SET 命令发出；只有 GET 没 SET，说明缓存压根没写入
• 高频接口别依赖短 TTL，用 Cache::rememberForever() + 主动失效（Cache::forget()），减少 Redis 过期键扫描压力
• 上线后偶尔超时？检查连接池：Laravel 默认每请求新建连接，高并发下容易耗尽；可在 config/database.php 的 redis 配置里加 'options' => ['connection_pool' => ['pool_size' => 20]]

最常被忽略的一点：改完配置不跑 php artisan config:clear，Laravel 就永远读缓存过的旧配置；哪怕 .env 改对了，config/database.php 也同步了，不清理缓存文件，一切白搭。

理论要掌握，实操不能落！以上关于《Laravel Redis缓存配置与加速技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！