Laravel连接Azure Redis 2分片集群报错求助

针对你遇到的Azure Redis集群连接问题，以下是经过验证的phpredis和Predis配置方案，无需手动指定所有节点，客户端会自动发现集群拓扑：

一、phpredis客户端配置 #

确保你的phpredis扩展版本≥5.3.0，修改config/database.php中的Redis配置：

'redis' => [
    'client' => 'phpredis',
    'cluster' => 'redis', // 启用原生Redis集群模式
    'options' => [
        'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_') . '_database_'),
        'parameters' => [
            'password' => env('REDIS_PASSWORD'), // 全局密码，自动应用到所有集群节点
            'ssl' => [
                'verify_peer' => false,
                'verify_peer_name' => false,
            ],
        ],
    ],
    'default' => [
        'host' => env('REDIS_HOST'), // Azure提供的集群端点
        'port' => env('REDIS_PORT', 6380), // Azure Redis集群默认SSL端口
        'database' => env('REDIS_DB', 0),
        'ssl' => true,
    ],
],

二、Predis客户端配置 #

确保Predis版本≥2.0，修改config/database.php：

'redis' => [
    'client' => 'predis',
    'options' => [
        'cluster' => 'redis', // 启用Redis集群模式
        'prefix' => env('REDIS_PREFIX', Str::slug(env('APP_NAME', 'laravel'), '_') . '_database_'),
        'scheme' => 'tls', // 强制使用TLS连接
        'context' => [
            'ssl' => [
                'verify_peer' => false,
                'verify_peer_name' => false,
            ],
        ],
        'parameters' => [
            'password' => env('REDIS_PASSWORD'), // 全局密码，自动应用到所有发现的节点
        ],
    ],
    'default' => [
        'host' => env('REDIS_HOST'), // Azure集群端点
        'port' => env('REDIS_PORT', 6380),
        'database' => env('REDIS_DB', 0),
    ],
],

三、关键注意事项 #

• 环境变量设置：确认.env中REDIS_HOST为Azure提供的集群完整主机名，REDIS_PORT=6380，REDIS_PASSWORD为集群访问密钥。
• 无需手动添加多节点：Azure Redis集群通过单一端点提供服务，客户端会自动从种子节点获取完整集群拓扑，无需手动列出所有分片节点。
• SSL强制要求：必须使用6380端口并启用SSL，否则无法连接Azure Redis集群。
• MOVED错误根源：之前的配置未正确启用原生集群模式，或未将SSL、密码等参数全局传递给所有节点，导致客户端无法处理集群重定向。
• 版本兼容性：确保phpredis或Predis的版本足够新，旧版本可能不支持Azure Redis集群的自动发现功能。

测试连接 #

添加简单路由验证连接是否正常：

Route::get('/test-redis-cluster', function () {
    try {
        Redis::set('cluster_test', 'success');
        return 'Redis集群连接成功: ' . Redis::get('cluster_test');
    } catch (\Exception $e) {
        return '连接失败: ' . $e->getMessage();
    }
});

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