
Redis 配置文件里 REDIS_HOST 连不上?先查 Laravel 的环境加载顺序
不是 .env 写错,而是 Laravel 在启动时会优先读取已加载的配置缓存,导致改了 .env 也不生效。php artisan config:clear 必须跑,但更关键的是确认 .env 文件权限是否允许 Web 用户读取(尤其 Docker 或 Nginx 部署时)。
REDIS_HOST 值不能是 localhost —— 容器内访问宿主 Redis 要用 host.docker.internal(Mac/Win)或宿主内网 IP(Linux)REDIS_PORT 默认是 6379,但有些云 Redis(如腾讯云、阿里云)默认开启加密代理,实际端口可能是 6380 或带密码重定向端口如果用了 redis-cli -h xxx -p xxx ping 能通,但 Laravel 报 Connection refused,大概率是 config/database.php 里 ‘redis’ 键下的 ‘default’ 配置没对齐 .env 的 key 名
Cache::get() 总返回 null?检查序列化与连接驱动匹配
Laravel 默认用 phpredis 扩展时,cache 配置里的 driver 必须设为 redis;若只装了 predis/predis 包而没装扩展,driver 得设成 redis 但底层走纯 PHP 实现——两者序列化格式不兼容,会导致写入和读取错乱。
运行 php –ri redis 确认 phpredis 扩展已启用;否则 Laravel 会静默 fallback 到 predis,但 predis 默认用 serialize,而 phpredis 默认用 igbinary(如果启用了)统一序列化方式:在 config/cache.php 的 stores.redis.options 下加 ‘serializer’ => ‘php’,避免跨环境反序列化失败Cache::get(‘key’) 返回 null 不一定代表没命中,也可能是值本身就是 null;要用 Cache::has(‘key’) 判断是否存在
页面速度没提升?确认缓存真正被 hit 了
很多项目开了 Redis 缓存,但请求日志里看不到 HIT,是因为 Laravel 默认对 view、route、config 等缓存做了独立开关,而业务数据得自己调 Cache::remember() 或 Cache::store(‘redis’)->get()。
不要依赖 php artisan optimize:clear 来提速——它只清编译类和路由缓存,跟 Redis 无关高频接口建议用 Cache::rememberForever() + 主动失效,而不是短 TTL,减少 Redis 的过期键扫描压力用 redis-cli monitor 实时看 Laravel 是否真发了 GET 和 SET 命令;如果只有 GET 没 SET,说明缓存没写入,可能是模型没实现 Cacheable 或漏了 remember()
上线后偶尔超时?注意连接池和 timeout 设置
Redis 连接不是无限复用的,Laravel 默认每个请求新建连接,高并发下容易耗尽连接数或触发超时,错误信息通常是 Redis server went away 或 read error on connection。
在 config/database.php 的 redis.clusters 或 redis.default 下加 ‘timeout’ => 1.5(单位秒),避免卡死整个请求用 ‘read_timeout’ => 1.0 单独控制读超时,防止大 value 反序列化阻塞如果用了 phpredis,可开启连接池:’persistent’ => true,但要配合 ‘retry_interval’ => 100 防止断连后疯狂重试事情说清了就结束。最常被忽略的是:环境变量修改后不清理配置缓存、序列化方式混用、以及误以为开了 Redis 就自动缓存所有查询——这三处一出问题,速度反而更慢。

评论(0)