Smart.StackRedis 3.0.1

Smart.StackRedis

基于 StackExchange.Redis 封装的现代化 Redis 客户端，支持 .NET6/8/9 平台和服务依赖注入，提供类型安全且符合现代.NET开发习惯的操作接口。

特性

• 原生依赖注入支持
• 全异步操作（async/await）
• 全局键前缀自动附加
• 内置分布式锁和原子操作
• 完整的发布订阅支持
• 模块化数据类型操作
• 自动重连和连接池管理
• JSON序列化集成

安装

bash
dotnet add package Smart.StackRedis

快速开始

服务注册

csharp
builder.Services.AddSmartRedis(new RedisOptions
{
  ConnectionString = Configuration.GetConnectionString("Redis"),
  KeyPrefix = "prod:"
});

基础使用

csharp
public class DataService(SmartRedisService redis) {
// 字符串操作
public async Task CacheUser(User user)
=> await redis.String.SetAsync($"users:{user.Id}", user);

// 哈希表操作
public async Task UpdateProfile(string userId, string field, object value)
=> await redis.Hash.SetAsync($"profiles:{userId}", field, value);

// 发布订阅
public async Task Notify(string message)
=> await redis.Subscribe.PublishAsync("notifications", message);
}

核心模块

配置选项

csharp
public class RedisOptions
{
  public string ConnectionString { get; set; } // Redis连接字符串
  public string KeyPrefix { get; set; } // 全局键前缀
}

json
// appsettings.json
{
"Redis": {
"ConnectionString": "localhost:6379,connectRetry=3",
"KeyPrefix": "prod:"
}
}

最佳实践

1. 键设计规范
   业务:环境:实体:ID 格式，如 orders:prod:2024

2. 批量操作优化

csharp
// 使用Pipeline批量写入
var batch = db.CreateBatch();
batch.StringSetAsync("key1", "value1");
batch.StringSetAsync("key2", "value2");
batch.Execute();

3. 异常处理

csharp
try
{
  await redis.String.SetAsync(...);
}
catch (RedisConnectionException ex)
{
  // 处理连接异常
}

注意事项

⚠️ 连接字符串必须包含 abortConnect=false
⚠️ 敏感配置建议使用加密存储
⚠️ 避免在热路径中频繁创建连接
⚠️ 发布订阅需处理消息积压问题
⚠️ Stream操作要求Redis 5.0+版本

Developed by zenglei