c#如何使用Redis_c#Redis项目实例附完整源码
使用最新版StackExchange.Redis，ConnectionMultiplexer必须全局单例并设置abortConnect=false，避免连接失败。对象存取需手动序列化，推荐JSON或MessagePack。并发更新优先使用Lua脚本保证原子性，防止竞态。Docker容器内注意DNS解析、网络模式及超时配置，避免连接超时。此外，合理设置超时与重
记住几个关键点：使用最新版 StackExchange.Redis（2.7.x+），ConnectionMultiplexer单例复用，显式配置abortConnect=false，对象存取必须手动序列化，并发更新优先用 Lua 脚本，Docker 环境里注意 DNS 和网络配置。这些做好了，基本不会踩坑。
直接用 StackExchange.Redis 就好，别碰过时的 ServiceStack.Redis，也别用 StackExchange.Redis 的 1.x 低版本——不然连接泄漏、异步死锁、序列化兼容性问题会让你头疼到怀疑人生。
安装和基础连接怎么配
NuGet 里装最新稳定版 StackExchange.Redis（目前是 2.7.x+），注意别装 StackExchange.Redis.StrongName，那个已经废弃了。
连接字符串建议把关键参数写清楚，别指望默认值能帮你兜底：
abortConnect=false：启动时如果连不上，别直接抛异常挂掉，先忍着connectTimeout=5000：5 秒超时，太短容易失败，太长拖慢服务启动syncTimeout=3000：同步操作的上限时间，防止线程池被阻塞allowAdmin=true：只在开发或调试时开，生产环境别开，不然执行FLUSHDB这种命令就太危险了
强烈推荐用 ConnectionMultiplexer 单例复用，不要每次 new 一个——它自己线程安全，内部管理连接池，你用 Lazy 或者 DI 容器注册成 Singleton 都行：
private static readonly LazyLazyConnection = new Lazy (() => ConnectionMultiplexer.Connect("localhost:6379,abortConnect=false,connectTimeout=5000"));
存取对象为什么报错“Unable to serialize”
StackExchange.Redis 默认只认 byte[]，你直接丢一个 string 或自定义类进去，它就会抛出 System.NotSupportedException: The collection type 'System.Collections.Generic.List`1' is not supported. 这种错误。别慌，序列化必须自己来。
推荐用 System.Text.Json（.NET Core 3.0+ 或 .NET 5+ 默认就有）：
- 存对象：
db.StringSet("user:1001", JsonSerializer.Serialize(user)) - 取对象：
var json = db.StringGet("user:1001"); var user = JsonSerializer.Deserialize(json!)
注意：如果项目强依赖 Newtonsoft.Json，也可以用 JsonConvert.SerializeObject，但必须确保所有属性 public 可读写，且没有循环引用。否则一样会炸。
如何安全地做并发更新（比如库存扣减）
千万别用“先 GET 再 SET”这种两步操作——竞态条件百分之百会发生。Redis 原生的 DECR、INCR、GETSET 都是原子的，但 C# 封装里要借助 IServer 或 Lua 脚本才能保证原子性。
最推荐的是 Lua 脚本，多条命令打包执行，原子性有保障：
var script = @"
if redis.call('GET', KEYS[1]) >= ARGV[1] then
return redis.call('DECRBY', KEYS[1], ARGV[1])
else
return -1
end";
var result = db.ScriptEvaluate(script, new RedisKey[] { "stock:item101" }, new RedisValue[] { "5" });
返回 -1 表示库存不够，其他值就是扣减后的剩余数量。注意脚本里下标从 1 开始，别写成 KEYS[0]，那是非法索引。
为什么本地跑得好，上 Linux 容器就超时
典型症状：.NET 6+ 应用在 Docker 里连 Redis 报 SocketFailure on GET 或 Timeout performing GET，但用 redis-cli -h redis 却能通。问题往往出在 DNS 解析和连接复用冲突上。
- Docker 默认用
bridge网络，localhost指向容器自己，不是宿主机 - 如果 Redis 跑在宿主机上，要改用
host.docker.internal（Docker Desktop）或宿主机真实 IP（Linux Docker 需要加--add-host参数） - 连接字符串里去掉
ssl=true，除非 Redis 真的开了 TLS
验证方法：进容器执行 ping redis（服务名）或 telnet redis 6379，不通就说明不是代码问题，是网络没通。
还有一个很容易被忽略的点：连接生命周期管理。ConnectionMultiplexer 不要轻易 Dispose 掉，除非应用整个退出。如果用了 DI 容器（比如 Microsoft.Extensions.DependencyInjection），注册成 Singleton 就行，别手动调 .Close() 或 .Dispose()，否则下次再操作就会重新创建连接，白白浪费性能。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。