Laravel 11调用Redis::set()报Class 'Redis'未找到错误排查

核心问题定位 #

你遇到的「Class "Redis" not found」报错，大概率是混淆了Laravel Redis门面与原生PHP Redis扩展类，或是配置缓存、门面注册环节出了问题。以下是具体排查步骤和解决办法：

1. 区分Laravel门面与原生Redis类 #

• 你使用的\Redis::set()是原生PHP Redis扩展的类，和你配置的predis客户端完全无关。如果本地没安装PHP的redis扩展，这个类必然不存在。
• Laravel基于predis封装的门面是Illuminate\Support\Facades\Redis，正确用法是先引入该类，再调用Redis::set()，不要用全局的\Redis。

2. 清除配置缓存 #

Laravel 11默认启用配置缓存，修改.env或database.php后，旧配置可能仍在生效。执行以下命令清除缓存：

php artisan config:clear

3. 验证Redis门面的可用性 #

通过Artisan Tinker快速测试门面是否正常：

1. 运行tinker：

   php artisan tinker
   

2. 执行测试代码：

   Illuminate\Support\Facades\Redis::set('test_key', 'test_value');
   echo Illuminate\Support\Facades\Redis::get('test_key');
   

如果能正常输出test_value，说明门面本身没问题；如果报错，检查项目是否禁用了门面：
打开bootstrap/app.php，确认存在->withFacades()（Laravel 11默认启用，若设置为false则会禁用门面）。

4. 检查自定义命令的命名空间 #

如果是在自定义Artisan命令中使用Redis，必须在命令类顶部明确引入门面：

use Illuminate\Support\Facades\Redis;

不要依赖全局别名（若别名未正确注册会失效）。

5. 确认predis配置正确性 #

• 打开config/database.php，确保redis配置块的client值为predis：

  'redis' => [
      'client' => env('REDIS_CLIENT', 'predis'),
      // 其余连接配置（如host、port）需匹配本地Redis服务
  ]
  

• 检查.env文件，确认REDIS_CLIENT=predis无拼写错误。

正确使用示例 #

以下是自定义Artisan命令中使用Redis的完整示例：

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Redis;

class TestRedisConnection extends Command
{
    protected $signature = 'redis:test';
    protected $description = 'Test Redis connection and operations';

    public function handle()
    {
        // 设置缓存
        Redis::set('laravel_redis_test', 'Hello from Laravel 11 + Predis');
        // 获取缓存
        $value = Redis::get('laravel_redis_test');
        
        $this->info("Redis operation succeeded! Value: {$value}");
        return Command::SUCCESS;
    }
}

运行命令测试：

php artisan redis:test

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