valueoperations.increment 能保证原子性是因为其底层调用 redis 的 incr 等单线程命令；需通过 redistemplate 获取实例，推荐使用 stringredistemplate 或配置兼容数值的序列化器；key 不存在时自动初始化为 0；不支持条件更新或重置，复杂逻辑应使用 lua 脚本。
ValueOperations.increment 为什么能保证原子性
increment 调用的是 Redis 的 INCR、INCRBY 或 INCRBYFLOAT 命令，这些命令在 Redis 服务端单线程执行，天然具备原子性。Spring Boot 的 ValueOperations 只是封装了这一能力，并不依赖 JVM 锁或分布式锁 —— 所以只要连接的是同一个 Redis 实例（或集群中正确路由到同一 slot），就无需额外加锁。
注意：如果使用 Redis Cluster，increment 对 key 的要求和普通命令一致 —— key 必须落在同一 slot；否则会抛出 RedisClusterException。常见坑是直接对带变量的 key（如 "user:123:score"）调用，但没确保 hash tag（比如改用 "user:{123}:score"）。
如何正确配置并获取 ValueOperations 实例
别手动 new ValueOperations，它必须从 RedisTemplate 获取，且序列化器必须兼容数值类型。默认的 JdkSerializationRedisSerializer 会导致 increment 失败（报 ClassCastException 或空指针），因为 Redis 返回的是字符串，而反序列化试图转成对象。
推荐做法：
- 使用
StringRedisTemplate（它内部的ValueOperations默认操作String类型） - 或为普通
RedisTemplate显式设置valueSerializer为GenericJackson2JsonRedisSerializer或StringRedisSerializer - 避免混用不同序列化器：比如 key 用
StringRedisSerializer，value 却用Jackson，increment会因解析失败返回 null
示例（推荐）：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
StringRedisTemplate stringRedisTemplate = ...;
ValueOperations<string string> ops = stringRedisTemplate.opsForValue();
Long result = ops.increment("counter:login:202406"); // 成功返回新值</string>
increment 返回值与初始状态的陷阱
increment 在 key 不存在时，会先初始化为 0 再执行加法，并返回 1（整型）或 1.0（浮点型）。但这个“初始化”只发生在 Redis 层，不会触发你自定义的默认值逻辑（比如你想初始化为 100，它仍从 0 开始加）。
常见误判场景：
- 以为
increment("key", 5)会“确保 key 存在且至少为 5”，其实它只做加法，不校验业务语义 - 用
Double类型调用increment，但之前用Long写过同 key —— Redis 不区分类型，但序列化器可能解析失败，导致返回 null - 并发下反复调用
increment后查get，发现值比预期小 —— 很可能是某次调用后没处理返回值，或被其他未使用原子操作的代码覆盖了
需要原子重置或条件更新时不能只靠 increment
increment 只负责“读+加+写”三步原子，不提供 compare-and-set、reset-on-threshold、TTL 绑定等能力。比如实现“每小时计数器自动归零”，不能靠 increment 自己完成。
可行方案：
- 用 Lua 脚本封装逻辑（如先
GET再判断再INCR或SET），通过RedisTemplate.execute()调用 - 结合 Redis 过期时间：每次
increment前先expire，或用setIfAbsent初始化时指定 TTL - 业务层兜底：比如用
@Scheduled定时清理旧 key，而非强依赖原子性覆盖
真正容易被忽略的是：Redis 的原子性只覆盖单命令或 Lua 脚本内多命令，一旦逻辑跨多个 Redis 操作（哪怕只是 increment 后紧跟一个 expire），就不再原子 —— 这时候必须合并为脚本或接受最终一致性。
