C#如何连接Redis并使用StackExchange.Redis进行数据操作

在C#后端开发中，使用StackExchange.Redis库可以高效稳定地连接和操作Redis服务。它是官方推荐的.NET Redis客户端，提供了连接多路复用、异步API和丰富的数据类型支持。

安装与引用

首先通过NuGet安装StackExchange.Redis包，可以在包管理器控制台执行以下命令：

// 使用NuGet安装命令
// Install-Package StackExchange.Redis

安装完成后，在代码文件中引用命名空间：

using StackExchange.Redis;

创建连接实例

ConnectionMultiplexer是线程安全的，整个应用应复用同一个实例，不要每次操作都新建连接。基础连接配置如下：

// 配置Redis连接
ConfigurationOptions config = new ConfigurationOptions
{
    EndPoints = { "127.0.0.1:6379" },
    Password = "yourpassword", // 如果没有密码可省略
    AbortOnConnectFail = false,
    ConnectTimeout = 5000
};

// 创建并复用连接
ConnectionMultiplexer redis = ConnectionMultiplexer.Connect(config);
IDatabase db = redis.GetDatabase();

常用数据操作

字符串读写

使用StringSet和StringGet方法操作字符串类型：

// 写入字符串，设置过期时间60秒
bool setResult = db.StringSet("user:1:name", "张三", TimeSpan.FromSeconds(60));

// 读取字符串
string name = db.StringGet("user:1:name");
Console.WriteLine(name);

Hash类型操作

Hash适合存储对象属性，示例如下：

// 写入Hash字段
db.HashSet("user:1", new HashEntry[]
{
    new HashEntry("age", 28),
    new HashEntry("email", "test@ipipp.com")
});

// 读取单个字段
string age = db.HashGet("user:1", "age");

异常处理建议

网络波动可能导致Redis操作失败，建议使用try-catch包裹关键逻辑，并结合重试机制：

try
{
    db.StringSet("key", "value");
}
catch (RedisConnectionException ex)
{
    // 记录日志或进行重试
    Console.WriteLine("Redis连接异常：" + ex.Message);
}

总结

通过StackExchange.Redis连接Redis并不复杂，核心是正确配置ConnectionMultiplexer并复用实例。实际项目中还应关注连接池、超时和异常，才能构建稳定的缓存层。

C#RedisStackExchange_Redis连接配置缓存操作修改时间：2026-07-25 08:54:16