切换APP_ENV至production后Redis缓存失效，报ReflectionException错误

嘿，这个问题我之前部署Laravel项目时也碰到过，结合你描述的场景——切换APP_ENV到production就报错，切回local或者把SESSION_DRIVER改成file就恢复正常，大概率是Redis相关的配置或依赖出了问题，下面给你一步步排查解决的方法：

问题根源分析 #

从报错信息和堆栈追踪来看，问题出在调用createCacheHandler('redis')时找不到对应的缓存类，这一般是以下几种情况导致的：

• 生产环境未安装Redis扩展或Predis客户端
• Redis配置不正确，且生产环境下Laravel缓存了错误的配置
• Session配置里指定的Redis连接不存在

具体解决步骤 #

1. 确认Redis相关依赖已安装 #

Laravel支持两种Redis客户端：phpredis（PHP扩展）和predis（纯PHP库），你得确保其中一种已经安装：

• 检查phpredis扩展：在服务器上运行php -m，看输出里有没有redis。如果没有，就安装它：

  # 用pecl安装（适用于大部分PHP版本）
  pecl install redis
  # 然后在php.ini里添加一行 extension=redis.so，重启PHP服务
  

• 如果用Predis：确保已经通过Composer安装了依赖：

  composer require predis/predis
  

2. 验证Redis配置正确性 #

打开config/database.php，检查Redis配置块，确保生产环境下的连接参数是对的：

'redis' => [
    'client' => env('REDIS_CLIENT', 'phpredis'), // 这里要和你实际用的客户端一致
    'default' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => env('REDIS_DB', 0),
    ],
    // 如果Session用了单独的Redis连接，也要确保这个连接配置正确
    'session' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => env('REDIS_SESSION_DB', 1),
    ],
],

同时检查你的.env（或.env.production）文件，确保REDIS_HOST、REDIS_PORT、REDIS_PASSWORD这些参数和生产环境的Redis实例匹配，REDIS_CLIENT也和你安装的客户端一致。

3. 重新生成生产环境的配置缓存（关键！） #

Laravel在production环境下默认会使用缓存的配置文件，如果你切换环境后没有重新生成配置缓存，旧的缓存可能还是local环境的配置，或者包含错误的Redis信息。运行以下命令更新配置缓存：

php artisan config:cache

⚠️ 注意：运行这个命令后，所有env()函数的调用都会被替换成缓存时的静态值，所以一定要确保你的.env文件里的参数都正确再执行！

4. 检查Session配置 #

打开config/session.php，确认Session的驱动和Redis连接配置：

'driver' => env('SESSION_DRIVER', 'file'),
// 如果指定了Session用的Redis连接，要确保这个连接在database.php里存在
'connection' => env('SESSION_CONNECTION', 'default'),

如果SESSION_CONNECTION设置了某个特定的Redis连接（比如session），一定要确保这个连接在config/database.php的Redis配置块里已经定义。

5. 测试Redis连接 #

最后可以简单测试一下生产环境的Redis是否能正常连接：

• 用Laravel自带的命令：php artisan redis:cli，如果能正常进入Redis命令行，说明连接没问题。
• 或者写个简单的测试脚本：

<?php
require __DIR__.'/vendor/autoload.php';
$redis = new Redis();
$redis->connect(env('REDIS_HOST'), env('REDIS_PORT'));
if ($redis->ping()) {
    echo "Redis连接成功！";
} else {
    echo "Redis连接失败，请检查配置！";
}

一般来说，做完上面这几步，问题就能解决了。如果还是不行，可以检查Laravel的日志文件（storage/logs/laravel.log），里面会有更详细的错误信息，帮你定位问题。

内容的提问来源于stack exchange，提问作者Curtis