Laravel项目迁移redis缓存配置修复-php教程-PHP中文网

cache::get()静默返回null的根源是redis缓存未真正启用，需同时满足驱动启用、连接配置对齐、配置固化三条件。先验证redis-cli ping通且php扩展加载，再确保.env含cache_driver=redis等五项并执行config:clear与config:cache，最后确认config/database.php中redis.cache连接存在且client匹配实际扩展。

laravel项目迁移redis缓存配置修复

Cache::get() 静默返回 null，不是代码写错了，而是迁移后 Redis 缓存根本没走通——驱动未启用、连接未对齐、配置未固化，三者缺一不可。

确认 Redis 服务可达且 PHP 扩展已加载

跳过这步，后续所有配置都是空转。Laravel 不会报错，但 Cache::get() 永远拿不到值。

终端执行 redis-cli -h $REDIS_HOST -p $REDIS_PORT -a "$REDIS_PASSWORD" ping，必须返回 PONG；Docker 环境下 $REDIS_HOST 不能是 127.0.0.1，得填容器名（如 redis）或宿主机网关（如 172.17.0.1）
运行 php artisan tinker，输入 Redis::ping()：若报 Class 'Redis' not found，说明 phpredis 扩展没启用；若报认证失败，检查 REDIS_PASSWORD 是否对应 Redis 的 ACL 用户密码（Redis 6+ 不再用 requirepass）
php -m | grep redis 必须输出 redis，否则扩展未加载

驱动启用 + 配置固化必须同步完成

CACHE_DRIVER=redis 写进 .env 只是开关，不执行清缓存命令，Laravel 仍读 bootstrap/cache/config.php 里的旧配置。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

确保 .env 包含这五行（值按实际调整）：
CACHE_DRIVER=redis
REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=null
REDIS_DB=0
立刻执行：php artisan config:clear → 删除编译缓存
php artisan config:cache → 重新固化配置（漏掉这步，改一百遍 .env 都无效）
验证是否生效：php artisan tinker → 输入 config('cache.default')，返回 "redis" 才算成功

检查 config/database.php 中的 redis 连接定义

Laravel 缓存复用的是 config/database.php 里的 redis 配置，不是 .env 单独控制。常见故障是只改了环境变量，却忘了配对连接。

打开 config/database.php，找到 'redis' 数组，确认其中存在名为 'cache' 的连接（默认 key）：
'cache' => [ 'host' => env('REDIS_HOST', '127.0.0.1'), 'password' => env('REDIS_PASSWORD'), 'port' => env('REDIS_PORT', 6379), 'database' => env('REDIS_CACHE_DB', 1) ]
'client' 值必须与已安装扩展一致：'client' => 'phpredis'（对应 phpredis 扩展）或 'client' => 'predis'（对应 predis/predis Composer 包）
如果 config/cache.php 里 'stores.redis.connection' 被改成其他名字（如 'production_cache'），那 config/database.php 里也必须有同名连接定义，否则 Cache::store('redis') 会静默失败

避免键冲突和前缀混淆

默认 cache 和 session 共用 database 0，Cache::flush() 会清掉用户登录态；另外，没设 prefix 会导致多项目共用 Redis 时 key 冲突。

在 config/cache.php 的 'redis' store 下加一行：
'prefix' => env('CACHE_PREFIX', 'laravel_app_v2:')
确保 config/database.php 中 'redis.cache.database' 和 'redis.session.database' 分开（如 cache 用 db 1，session 用 db 2）
验证前缀是否生效：Cache::store('redis')->put('test', 'ok')，然后用 redis-cli -n 1 KEYS "laravel_app_v2:*" 查看是否命中

最易被忽略的是：config:cache 命令执行前，APP_KEY 必须已生成且未被注释；而 Cache::get() 返回 null 时，90% 情况下是因为 config/database.php 里 redis.cache 连接压根不存在，或者 client 值写成了 phpredis 但实际装的是 predis。