.NET6中StackExchange.Redis StringSetAsync参数及过期问题问询

三个参数的具体作用 #

• 第3个参数expiry（TimeSpan?类型）：指定键的自动过期时间。传null时，键不会自动过期，除非后续通过KeyExpireAsync手动设置过期。你遇到示例1中键过期的情况，大概率是该键之前已被设置过过期时间，或是其他代码逻辑修改了它的过期属性——示例1传null本身不会让键过期。
• 第4个参数when（When枚举）：控制设置键的触发条件。When.Always是默认值，意思是无论键是否存在，直接覆盖值；其他可选值包括When.Exists（仅键存在时才更新）、When.NotExists（仅键不存在时才创建）。
• 第5个参数flags（CommandFlags枚举）：指定命令执行的额外标记，比如CommandFlags.FireAndForget（不等待Redis响应）、CommandFlags.PreferReplica（优先从副本节点操作）等。CommandFlags.None是默认值，代表无特殊执行要求。

两种调用方式的默认行为对比 #

示例2的简化写法_database.StringSetAsync(rediskey, value);，本质是调用了带默认参数的重载，完全等价于示例1的写法——都不会让键自动过期。两者的执行效果没有区别，只是示例2更简洁。

键过期问题排查方向 #

你遇到的键过期情况，和这两种调用方式无关，建议从以下几点排查：

• 检查该键是否在其他代码逻辑中被调用KeyExpireAsync设置了过期时间；
• 确认该键之前是否被设置过过期，本次调用仅覆盖了值但保留了原有过期属性（Redis的SET命令默认不修改已存在键的过期时间）；
• 查看Redis服务器的内存淘汰策略，是否因内存不足导致键被自动清理。

使用建议 #

• 若只是单纯设置键值，无特殊条件或执行要求，直接用示例2的简化写法即可，代码更易读；
• 若需要控制设置条件（比如避免覆盖已存在的键），或指定命令执行标记，再使用带参数的重载：
  • 仅当键不存在时创建：_database.StringSetAsync(rediskey, value, null, When.NotExists, CommandFlags.None);
  • 设置键24小时后过期：_database.StringSetAsync(rediskey, value, TimeSpan.FromHours(24));
• 若键莫名过期，可通过Redis的TTL命令查看键的剩余过期时间，SCAN命令遍历相关键，或查看服务器操作日志（若开启）来定位原因。

内容的提问来源于stack exchange，提问作者Ramachandra