如何为StackExchange.Redis的StringGetAsync实现带CancellationToken的1秒超时？

针对你遇到的StackExchange.Redis中StringGetAsync不支持传入CancellationToken的问题，有两种可靠的方式实现1秒超时自动中止：

方法一：通过Task.WhenAny实现单请求超时控制 #

这种方式适合需要为单个请求自定义超时的场景，核心思路是将Redis操作任务与超时任务并行执行，优先响应先完成的任务：

using System;
using System.Threading;
using System.Threading.Tasks;
using StackExchange.Redis;

public async Task<RedisValue> GetRedisValueWithTimeoutAsync(IDatabase redisDb, RedisKey key)
{
    const int timeoutMs = 1000;
    using var timeoutCts = new CancellationTokenSource(timeoutMs);

    // 启动Redis GET操作
    var redisTask = redisDb.StringGetAsync(key);
    // 等待Redis任务或超时信号
    var completedTask = await Task.WhenAny(redisTask, Task.Delay(Timeout.Infinite, timeoutCts.Token));

    if (completedTask != redisTask)
    {
        // 超时触发，可抛出异常或返回默认值
        throw new TimeoutException($"Redis GET请求超时，已超过{timeoutMs}毫秒");
        // 若无需抛出异常，可返回：return RedisValue.Null;
    }

    // 返回Redis查询结果
    return await redisTask;
}

注意：这种方式会让你的API快速响应超时，但StackExchange.Redis底层的网络请求不会立即终止，不过不会影响业务逻辑的超时控制。

方法二：配置客户端全局超时 #

如果所有Redis操作都需要统一的超时规则，推荐直接在ConnectionMultiplexer初始化时配置全局超时，这种方式能真正中止底层网络请求：

using StackExchange.Redis;

// 初始化Redis连接配置
var redisConfig = new ConfigurationOptions
{
    EndPoints = { "你的Azure Redis端点:6380" },
    Password = "你的Redis访问密钥",
    Ssl = true,
    // 设置异步操作超时为1秒（单位：毫秒）
    AsyncTimeout = 1000,
    // 同步操作超时也可按需设置
    SyncTimeout = 1000
};

// 创建连接多路复用器
var multiplexer = ConnectionMultiplexer.Connect(redisConfig);
var redisDb = multiplexer.GetDatabase();

配置完成后，所有StringGetAsync操作一旦超过1秒，客户端会自动抛出RedisTimeoutException，无需额外编写超时逻辑。

两种方案对比 #

• 单请求超时：灵活性高，可针对不同请求设置不同超时，但底层请求不会立即终止。
• 全局超时：实现简单，能彻底中止底层网络请求，适合统一超时规则的场景。

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