CSRedisCore依赖注入配置指南：在ASP.NET Core中优雅使用Redis

CSRedisCore依赖注入配置指南：在ASP.NET Core中优雅使用Redis

如果你正在构建一个需要高性能数据访问的ASP.NET Core应用，那么将Redis集成进来几乎是必然的选择。无论是作为分布式缓存来缓解数据库压力，还是用作会话存储来支持横向扩展，Redis都能显著提升应用的响应速度和可扩展性。然而，直接将Redis客户端实例硬编码在控制器或服务里，很快就会让代码变得难以测试和维护。这时候，依赖注入（DI）就成了我们组织代码、管理依赖生命周期的利器。

CSRedisCore作为一款在.NET开发者社区中广受好评的Redis客户端，以其轻量、高效和功能全面著称。但很多开发者初次接触时，往往止步于简单的new CSRedisClient()调用，错过了它通过ASP.NET Core内置DI容器进行优雅集成的强大能力。这篇文章就是为你准备的。我们将抛开那些零散的代码片段，深入探讨如何在现代ASP.NET Core项目（特别是.NET 6及更高版本）中，从零开始，以最佳实践的方式配置和使用CSRedisCore。你会看到如何将配置外化到appsettings.json，如何处理多Redis节点环境，如何为不同的业务场景注册不同的客户端，以及如何编写易于测试的服务层代码。我们的目标不仅仅是让Redis跑起来，而是让它跑得优雅、可靠，并且与你的应用架构完美融合。

1. 项目初始化与基础环境搭建

在开始编写任何CSRedisCore的代码之前，我们需要确保项目环境是正确的。这里假设你正在使用.NET 6、.NET 7或更高版本，因为这些版本采用了全新的最小主机模型，配置方式与之前的Startup.cs模式有显著不同。如果你还在使用.NET Core 3.1或.NET 5，思路是相通的，只是代码存放的位置略有差异。

首先，创建一个新的ASP.NET Core Web API项目。你可以通过Visual Studio的向导，或者使用.NET CLI命令：

dotnet new webapi -n RedisIntegrationDemo
cd RedisIntegrationDemo

接下来，通过NuGet为项目添加CSRedisCore包。在项目根目录下执行：

dotnet add package CSRedisCore

这个命令会将最新稳定版本的CSRedisCore添加到你的项目文件中。现在，打开appsettings.json文件，我们需要在这里定义Redis的连接字符串。将配置与代码分离是良好的实践，它允许你在不同环境（开发、测试、生产）下轻松切换配置，而无需重新编译。

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "ConnectionStrings": {
    "Redis": "127.0.0.1:6379,defaultDatabase=0,password=yourStrongPassword,connectTimeout=5000,poolsize=50"
  },
  "AllowedHosts": "*"
}

注意：请务必将password=yourStrongPassword替换为你Redis实例的实际密码。如果本地Redis没有设置密码，可以省略password参数。poolsize=50设置了连接池的大小，这对于高并发应用非常重要，可以避免频繁创建和销毁连接带来的开销。

连接字符串的格式非常灵活，除了上面用到的基本参数，还有一些高级选项值得了解：

参数名	说明	示例值	默认值
defaultDatabase	连接后默认选择的Redis逻辑数据库编号。	0	0
password	Redis认证密码。	myPass123	(无)
connectTimeout	连接建立的超时时间（毫秒）。	5000	5000
syncTimeout	同步操作命令的超时时间（毫秒）。	10000	10000
poolsize	连接池大小。	50	50
idleTimeout	连接在池中的最大空闲时间（毫秒），超时会被回收。	20000	20000
preheat	是否在初始化时预热连接池。	true	false
ssl	是否使用SSL加密连接。	true	false
writeBuffer	写入缓冲区大小（字节）。	10240