使用Redis OM连接Redis实例超时问题求助

核心问题分析 #

从错误日志和代码来看，存在两个关键矛盾点：

• 模型标注StorageType.Json，但Redis OM生成的FT.CREATE命令却是基于Hash的，类型不匹配会导致命令执行异常，进而触发超时
• Azure Redis的网络环境特性，默认5秒超时不足以应对跨区域或高延迟场景

解决方案步骤 #

1. 修正模型存储类型与索引的匹配 #

你的ClassRoom类标注了StorageType.Json，但Redis OM生成的索引命令是ON Hash，这会导致命令执行失败。修改模型注解，确保索引与存储类型一致：

[Document(StorageType = StorageType.Json, Prefixes = new[] { "ClassRoom" })]
public sealed class ClassRoom
{
    [RedisIdField][Indexed] public string Id { get; set; }
    // 针对JSON嵌套的Person列表，需正确指定JsonPath到数组元素的Id
    [Indexed(JsonPath = "$.Persons[*].Id")] 
    public List<Person> Persons { get; set; }
}

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
}

修正后，Redis OM会生成正确的JSON类型索引命令，格式应为：

FT.CREATE ClassRoom-idx ON JSON PREFIX 1 ClassRoom SCHEMA $.Id TAG SEPARATOR | $.Persons[*].Id TAG SEPARATOR |

2. 调整Azure Redis连接字符串参数 #

Azure Redis强制要求SSL，且默认5秒超时可能不够，修改连接字符串增加SSL配置和更长的超时：

redis://:password@my-dev-redisServer.redis.server.windows.net:6380?ssl=true&timeout=15000&syncTimeout=15000

• ssl=true：符合Azure Redis的SSL强制要求
• timeout=15000：将超时时间从5秒延长至15秒，适配网络延迟
• syncTimeout=15000：同步命令超时同步调整

3. 确认Redis实例已启用RediSearch模块 #

Azure Redis基础版/标准版默认未预装RediSearch模块，需要升级到Redis Stack实例，或在Azure门户中手动启用对应模块，否则无法执行FT.CREATE命令。

4. 优化索引创建时机 #

在HostedService中创建索引时，需确保Redis连接完全就绪，避免应用启动初期连接未建立就执行命令：

public class IndexCreationService : IHostedService
{
    private readonly IRedisConnectionProvider _connectionProvider;

    public IndexCreationService(IRedisConnectionProvider connectionProvider)
    {
        _connectionProvider = connectionProvider;
    }

    public async Task StartAsync(CancellationToken cancellationToken)
    {
        // 等待Redis连接就绪
        await _connectionProvider.Connection.WaitUntilReadyAsync(cancellationToken);
        // 创建索引
        await _connectionProvider.RedisCollection<ClassRoom>().CreateIndexAsync(cancellationToken);
    }

    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
}

5. 排查服务器端负载 #

错误日志中qs:10表示Redis服务器有10个待处理请求，可能是服务器负载过高导致超时：

• 登录Azure门户查看Redis实例的CPU使用率、内存占用、网络带宽
• 检查是否有其他大量读写请求占用服务器资源

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