Spring Boot集成Azure Cache for Redis时getAndExpire/GETEX报错问题

问题本质 #

GETEX是Redis 6.0+原生支持的命令，但出现该错误通常是Spring Data Redis客户端版本不兼容、客户端配置未适配Redis 6.0协议，或Azure Redis实例存在命令限制导致的。以下是针对性解决方案：

1. 校验Spring Data Redis版本兼容性 #

Spring Data Redis对GETEX的支持依赖版本匹配，早期版本不会自动映射该命令，而是用GET+EXPIRE的非原子组合。需确保你的Spring Boot与Spring Data Redis版本适配：

• Spring Boot 2.4+对应的Spring Data Redis版本已支持GETEX
• 检查pom.xml中的spring-boot-starter-data-redis版本，建议升级到对应Spring Boot分支的稳定版（如2.7.x或3.x系列）

示例pom.xml依赖片段（以Spring Boot 2.7.x为例）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
    <version>2.7.15</version>
</dependency>

2. 调整Redis客户端配置 #

若使用默认的Lettuce客户端，需确保配置未限制命令集或使用旧协议版本。可显式指定协议版本适配Redis 6.0：

@Bean
public LettuceConnectionFactory redisConnectionFactory() {
    // 构建客户端配置，指定兼容Redis 6.0的协议版本
    LettuceClientConfiguration clientConfig = LettuceClientConfiguration.builder()
            .protocolVersion(ProtocolVersion.RESP2) // Redis 6.0兼容RESP2/RESP3，选RESP2兼容性更广
            .build();
    
    RedisStandaloneConfiguration serverConfig = new RedisStandaloneConfiguration();
    serverConfig.setHostName("你的Azure Redis主机名");
    serverConfig.setPort(6380); // Azure Redis默认SSL端口
    serverConfig.setPassword(RedisPassword.of("你的Redis访问密钥"));
    
    return new LettuceConnectionFactory(serverConfig, clientConfig);
}

3. 手动实现滑动过期（替代方案） #

若暂时无法升级客户端版本，可通过Lua脚本实现原子性的GET+EXPIRE组合，模拟滑动过期效果：

字符串类型滑动过期 #

@Autowired
private StringRedisTemplate redisTemplate;

public String getAndRefreshExpire(String key, Duration expireDuration) {
    String luaScript = """
            local value = redis.call('GET', KEYS[1])
            if value then
                redis.call('EXPIRE', KEYS[1], ARGV[1])
            end
            return value
            """;
    return redisTemplate.execute(
            new DefaultRedisScript<>(luaScript, String.class),
            Collections.singletonList(key),
            String.valueOf(expireDuration.getSeconds())
    );
}

哈希类型滑动过期 #

Redis 6.0无HGETEX命令，需通过Lua脚本实现HGET+EXPIRE的原子操作：

public String hGetAndRefreshExpire(String key, String hashField, Duration expireDuration) {
    String luaScript = """
            local value = redis.call('HGET', KEYS[1], ARGV[1])
            if value then
                redis.call('EXPIRE', KEYS[1], ARGV[2])
            end
            return value
            """;
    return redisTemplate.execute(
            new DefaultRedisScript<>(luaScript, String.class),
            Collections.singletonList(key),
            hashField,
            String.valueOf(expireDuration.getSeconds())
    );
}

4. 检查Azure Redis的命令权限 #

登录Azure门户，进入你的Redis实例：

1. 切换到访问控制或高级设置
2. 检查命令允许列表，确保GETEX未被禁用（默认允许所有命令）
3. 执行INFO server命令确认Azure Redis实例实际版本为6.0+

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