直接用GarnetClient可无缝替换StackExchange.Redis，但需.NET 8且禁用非标准扩展；应异步连接、启用集群模式、避免泛型反序列化、服务端配置过期随机化防雪崩。
直接用 GarnetClient 就能连，不用改业务代码——前提是你的项目已升级到 .NET 8，并且没在用 StackExchange.Redis 的某些非标准扩展（比如自定义序列化器或管道批处理逻辑）。
怎么初始化 GarnetClient 并确保连接稳定
官方推荐的 GarnetClient 是同步构造、异步连接的模式，但很多人忽略 Connect() 的阻塞风险和重试边界。
- 不要在
Main()或 ASP.NET Core 启动时直接调用client.Connect()—— 它会同步等待 TCP 握手完成，超时默认是 30 秒，容易拖慢启动 - 正确做法是：先构造，再用
await client.ConnectAsync()，并包裹try/catch捕获SocketException和TimeoutException - 如果服务端启用了 TLS，必须传入
SslClientAuthenticationOptions，且TargetHost要和证书 CN 或 SAN 匹配，否则会静默失败（错误信息是"Authentication failed because the remote party has closed the transport stream."） - 连接后建议立即发一条
PING命令验证协议层是否就绪：await client.ExecuteForStringResultAsync("PING")
Set/Get 性能关键：别用泛型 Get<T> 做字符串读取
client.Get<string>("key") 看起来方便，但它内部会触发 JSON 反序列化（默认使用 System.Text.Json），哪怕值只是纯文本。实测比 client.Get("key") 慢 2–3 倍，99.9 分位延迟多出 80–120μs。
- 读字符串一律用无泛型
client.Get(string key)，返回string或null - 读数字用
client.Get<long>("counter")是安全的，Garnet 对整数类型有原生支持，不走 JSON - 写对象前自己序列化好再传：
client.Set("user:123", JsonSerializer.Serialize(user))，避免客户端做重复工作 - 批量操作优先用
client.MSet(...)和client.MGet(...)，比循环单条快 5 倍以上
集群模式下 Key 分布和故障转移怎么生效
Garnet 的集群模式（--cluster 启动）依赖客户端识别 MOVED / ASK 重定向响应，但 GarnetClient 默认不开启自动重定向，需要显式配置。
- 初始化时必须传入
new ClientOptions { EnableClusterMode = true }，否则遇到MOVED会直接抛RedisCommandException - 集群拓扑缓存默认 60 秒刷新一次，可通过
TopologyRefreshIntervalMs调整；但节点变更（如扩缩容）后，首次请求仍可能短暂失败，建议配合指数退避重试 - 主从切换期间，
GarnetClient不会自动感知新主节点，需依赖EnableClusterMode+ 重定向机制兜底，不是“连接池自动切” - 如果你用的是
LightClient，它压根不支持集群模式——它只认单 endpoint，强行连集群会报"Invalid response: MOVED"
过期策略和缓存雪崩防护要靠服务端配置，不是客户端控制
很多开发者试图在 Setex 里手动加随机秒数来防雪崩，这不可靠：时间计算分散在各服务，难统一，也易被绕过。Garnet 提供了服务端级的过期随机化开关。
- 启动 GarnetServer 时加参数
--expire-randomize-ratio 0.1（表示 ±10% 偏移），所有SETEX/EXPIRE请求都会被自动扰动 - 该功能对
SortedSetExpire等对象命令也生效，但仅限于服务端启用时，客户端无需改任何调用 - 注意：随机化只影响过期时间戳，不影响 TTL 查询结果——
TTL返回的是扰动后的剩余时间，不是原始设置值 - 如果你的应用强依赖精确过期（比如金融风控），就别开这个选项；否则建议默认开启，这是目前最省心的雪崩防护方式
真正容易被忽略的是连接生命周期管理：GarnetClient 不是线程安全的，不能跨线程复用；但也不建议每次请求都 new 一个——连接建立成本高。最佳实践是按业务域划分 GarnetClient 实例（比如用户服务一个、订单服务一个），并配合 IServiceProvider 单例注册，在应用退出时统一 Dispose()。
