Java中如何更新Redis键值且不改变剩余TTL？

要实现更新已存在Redis键值但不改变其剩余TTL的需求，核心是利用Redis原生命令的SET key value XX选项（仅当键存在时更新，且不修改过期时间），对应Spring Data Redis的实现方式如下：

1. 优先使用Spring Data Redis 2.0+的SetOption API #

Spring Data Redis 2.0及以上版本为ValueOperations提供了带SetOption参数的set方法，直接支持仅更新存在的键并保留TTL：

// 获取ValueOperations实例
ValueOperations<String, Object> valueOps = redisTemplate.opsForValue();

// 仅当键存在时更新值，完全保留原有TTL
valueOps.set("targetKey", "newValue", SetOption.ifPresent());

SetOption.ifPresent()对应Redis的XX参数，只会对已存在的键执行更新操作，不会触动其过期时间设置。如果键不存在，该方法不会做任何操作。

2. 旧版本Spring Data Redis的兼容方案 #

如果项目使用的是2.0之前的Spring Data Redis，没有SetOption，可以通过RedisCallback直接调用底层Redis命令：

redisTemplate.execute((RedisCallback<Void>) connection -> {
    // 序列化键和值
    byte[] keyBytes = redisTemplate.getKeySerializer().serialize("targetKey");
    byte[] valueBytes = redisTemplate.getValueSerializer().serialize("newValue");
    
    // 调用SET命令，指定SET_IF_PRESENT选项（即XX），过期时间设为persistent表示保留原有TTL
    connection.set(keyBytes, valueBytes, Expiration.persistent(), SetOption.SET_IF_PRESENT);
    return null;
});

3. 高并发场景的原子性保障 #

如果你的场景存在并发竞争（比如多个线程同时判断键存在并更新），上述两种方法的"仅更新存在键"是原子的，但如果需要先判断键存在再做额外逻辑，可能会出现竞态条件。此时推荐使用Lua脚本实现原子操作：

// Lua脚本：判断键存在则更新，返回1；不存在则返回0
String updateScript = "if redis.call('EXISTS', KEYS[1]) == 1 then " +
                      "redis.call('SET', KEYS[1], ARGV[1]) " +
                      "return 1 " +
                      "else " +
                      "return 0 " +
                      "end";

// 执行脚本
Long result = redisTemplate.execute(
        new DefaultRedisScript<>(updateScript, Long.class),
        Collections.singletonList("targetKey"),
        "newValue"
);

// 处理结果：1表示更新成功，0表示键不存在
if (result == 1) {
    // 更新成功逻辑
} else {
    // 键不存在逻辑
}

Lua脚本会被Redis原子性执行，避免了并发场景下的竞态问题。

注意事项 #

• 所有方法都只会更新已存在的键，若键不存在则无操作，因此如果需要处理键不存在的情况，可提前调用redisTemplate.hasKey("targetKey")判断，但高并发下建议用Lua脚本。
• 确保RedisTemplate的序列化器配置正确，避免键或值出现序列化/反序列化异常。

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