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设置了连接池的大小，这对于高并发应用非常重要，可以避免频繁创建和销毁连接带来的开销。

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