此版本仍在开发中，尚未被视为稳定版本。如需最新的稳定版本，请使用 Spring Data Redis 3.4.0！spring-doc.cn

Redis 缓存

Spring Data Redis 在包中提供了 Spring Framework 的缓存抽象的实现。要使用 Redis 作为后备实现，请将 RedisCacheManager 添加到您的配置中，如下所示：org.springframework.data.redis.cachespring-doc.cn

@Bean
public RedisCacheManager cacheManager(RedisConnectionFactory connectionFactory) {
    return RedisCacheManager.create(connectionFactory);
}

RedisCacheManager行为可以使用 RedisCacheManager.RedisCacheManagerBuilder 进行配置，从而允许您设置默认的 RedisCacheManager、事务行为和预定义缓存。spring-doc.cn

RedisCacheManager cacheManager = RedisCacheManager.builder(connectionFactory)
    .cacheDefaults(RedisCacheConfiguration.defaultCacheConfig())
    .transactionAware()
    .withInitialCacheConfigurations(Collections.singletonMap("predefined",
        RedisCacheConfiguration.defaultCacheConfig().disableCachingNullValues()))
    .build();

如前面的示例所示，允许基于每个缓存进行自定义配置。RedisCacheManagerspring-doc.cn

由 RedisCacheManager 创建的 RedisCache 的行为由定义。该配置允许您设置密钥过期时间、前缀和实现，以便与二进制存储格式相互转换，如以下示例所示：RedisCacheConfigurationRedisSerializerspring-doc.cn

RedisCacheConfiguration cacheConfiguration = RedisCacheConfiguration.defaultCacheConfig()
    .entryTtl(Duration.ofSeconds(1))
    .disableCachingNullValues();

RedisCacheManager 默认使用无锁的 RedisCacheWriter 来读取和写入二进制值。无锁缓存可提高吞吐量。缺少条目锁定可能会导致 and 操作出现重叠的非原子命令，因为这些命令需要将多个命令发送到 Redis。锁定对应项通过设置显式锁定键并检查是否存在此键来防止命令重叠，这会导致额外的请求和潜在的命令等待时间。CacheputIfAbsentcleanspring-doc.cn

锁定适用于缓存级别，而不是每个缓存条目。spring-doc.cn

可以按如下方式选择加入锁定行为：spring-doc.cn

RedisCacheManager cacheManager = RedisCacheManager
    .build(RedisCacheWriter.lockingRedisCacheWriter(connectionFactory))
    .cacheDefaults(RedisCacheConfiguration.defaultCacheConfig())
    ...

默认情况下，缓存条目的 any 都以实际缓存名称为前缀，后跟两个冒号（）。此行为可以更改为 static 和 computed 前缀。key::spring-doc.cn

以下示例显示如何设置静态前缀：spring-doc.cn

// static key prefix
RedisCacheConfiguration.defaultCacheConfig().prefixCacheNameWith("(͡° ᴥ ͡°)");

The following example shows how to set a computed prefix:

// computed key prefix
RedisCacheConfiguration.defaultCacheConfig()
    .computePrefixWith(cacheName -> "¯\_(ツ)_/¯" + cacheName);

cache 实现默认为 use 和 to clear the cache。可能会导致大型 keyspace 的性能问题。因此，可以使用 to switch to a based batch 策略创建默认值。该策略需要一定的批处理大小，以避免过多的 Redis 命令往返：KEYSDELKEYSRedisCacheWriterBatchStrategySCANSCANspring-doc.cn

RedisCacheManager cacheManager = RedisCacheManager
    .build(RedisCacheWriter.nonLockingRedisCacheWriter(connectionFactory, BatchStrategies.scan(1000)))
    .cacheDefaults(RedisCacheConfiguration.defaultCacheConfig())
    ...

使用任何驱动程序和 Redis 操作模式（独立、集群）都完全支持批处理策略。在使用 Lettuce 驱动程序时完全支持。 Jedis 仅支持非集群模式。KEYSSCANSCANspring-doc.cn

下表列出了的默认设置：RedisCacheManagerspring-doc.cn

表 1. 违约`RedisCacheManager`
设置	值
缓存写入器spring-doc.cn	非锁定、批处理策略`KEYS`spring-doc.cn
缓存配置spring-doc.cn	`RedisCacheConfiguration#defaultConfiguration`spring-doc.cn
初始缓存spring-doc.cn	没有spring-doc.cn
事务感知spring-doc.cn	不spring-doc.cn

下表列出了的默认设置：RedisCacheConfigurationspring-doc.cn

表 2.RedisCacheConfiguration 默认值
密钥过期	没有
缓存`null`spring-doc.cn	是的spring-doc.cn
前缀键spring-doc.cn	是的spring-doc.cn
默认前缀spring-doc.cn	实际缓存名称spring-doc.cn
密钥序列化器spring-doc.cn	`StringRedisSerializer`spring-doc.cn
值序列化器spring-doc.cn	`JdkSerializationRedisSerializer`spring-doc.cn
转换服务spring-doc.cn	`DefaultFormattingConversionService`使用默认缓存键转换器spring-doc.cn

默认情况下，统计信息处于禁用状态。用于收集本地命中和未命中，返回所收集数据的快照。RedisCacheRedisCacheManagerBuilder.enableStatistics()RedisCache#getStatistics()spring-doc.cn

Redis 缓存过期

空闲时间（TTI）和生存时间（TTL）的实现在定义和行为上各不相同，甚至在不同的数据存储中也是如此。spring-doc.cn

通常：spring-doc.cn

生存时间 （TTL）过期 - TTL 只能通过创建或更新数据访问操作来设置和重置。只要在 TTL 过期超时之前写入条目（包括在创建时），条目的超时就会重置为配置的 TTL 过期超时持续时间。例如，如果 TTL 过期超时设置为 5 分钟，则超时将在创建条目时设置为 5 分钟，并在此后更新 5 分钟后以及 5 分钟间隔到期之前重置为 5 分钟。如果 5 分钟内没有更新，即使在 5 分钟的间隔内该条目被读取了多次，甚至只读取了一次，该条目仍然会过期。必须写入该条目，以防止在声明 TTL 过期策略时该条目过期。spring-doc.cn
空闲时间 （TTI）过期 - 每当读取条目以及条目更新时，都会重置 TTI，并且实际上是 TTL 过期策略的扩展。spring-doc.cn

配置 TTL 时，某些数据存储会使条目过期，无论条目上发生何种类型的数据访问操作（读取、写入或其他操作）。在设置配置的 TTL 过期超时后，无论如何都会从数据存储中逐出该条目。驱逐操作（例如：destroy、invalidate、overflow-to-disk（用于持久存储）等）是特定于数据存储的。spring-doc.cn

生存时间（TTL）过期

Spring Data Redis 的实现支持缓存条目的生存时间 （TTL）过期。用户可以通过提供新接口的实现，为每个缓存条目配置固定或动态计算的 TTL 过期超时。CacheDurationDurationRedisCacheWriter.TtlFunctionspring-doc.cn

该接口是在 Spring Data Redis 中引入的。RedisCacheWriter.TtlFunction3.2.0spring-doc.cn

如果所有缓存条目都应在设定的持续时间后过期，则只需使用 fixed 配置 TTL 过期超时，如下所示：Durationspring-doc.cn

RedisCacheConfiguration fiveMinuteTtlExpirationDefaults =
    RedisCacheConfiguration.defaultCacheConfig().enableTtl(Duration.ofMinutes(5));

但是，如果 TTL 过期超时应因缓存条目而异，则必须提供接口的自定义实现：RedisCacheWriter.TtlFunctionspring-doc.cn

enum MyCustomTtlFunction implements TtlFunction {

    INSTANCE;

    @Override
    public Duration getTimeToLive(Object key, @Nullable Object value) {
        // compute a TTL expiration timeout (Duration) based on the cache entry key and/or value
    }
}

在后台，固定的 TTL 过期时间包装在返回提供的 .DurationTtlFunctionDurationspring-doc.cn

然后，您可以使用以下方法在全局基础上配置固定或动态的按缓存条目 TTL 过期：DurationDurationspring-doc.cn

全局固定持续时间 TTL 过期超时

RedisCacheManager cacheManager = RedisCacheManager.builder(redisConnectionFactory)
    .cacheDefaults(fiveMinuteTtlExpirationDefaults)
    .build();

或者：spring-doc.cn

全局、动态计算的按缓存条目 Duration TTL expiration timeout

RedisCacheConfiguration defaults = RedisCacheConfiguration.defaultCacheConfig()
        .entryTtl(MyCustomTtlFunction.INSTANCE);

RedisCacheManager cacheManager = RedisCacheManager.builder(redisConnectionFactory)
    .cacheDefaults(defaults)
    .build();

当然，您可以使用以下方法组合全局配置和每缓存配置：spring-doc.cn

全局固定持续时间 TTL 过期超时

RedisCacheConfiguration predefined = RedisCacheConfiguration.defaultCacheConfig()
                                         .entryTtl(MyCustomTtlFunction.INSTANCE);

Map<String, RedisCacheConfiguration> initialCaches = Collections.singletonMap("predefined", predefined);

RedisCacheManager cacheManager = RedisCacheManager.builder(redisConnectionFactory)
    .cacheDefaults(fiveMinuteTtlExpirationDefaults)
    .withInitialCacheConfigurations(initialCaches)
    .build();

空闲时间（TTI）过期

Redis 本身不支持真正的空闲时间（TTI）过期的概念。尽管如此，使用 Spring Data Redis 的 Cache 实现，可以实现类似空闲时间（TTI）过期的行为。spring-doc.cn

Spring Data Redis 的 Cache 实现中的 TTI 配置必须显式启用，即选择加入。此外，您还必须使用接口的固定或自定义实现提供 TTL 配置，如上文 Redis 缓存过期中所述。DurationTtlFunctionspring-doc.cn

例如：spring-doc.cn

@Configuration
@EnableCaching
class RedisConfiguration {

    @Bean
    RedisConnectionFactory redisConnectionFactory() {
        // ...
    }

    @Bean
    RedisCacheManager cacheManager(RedisConnectionFactory connectionFactory) {

        RedisCacheConfiguration defaults = RedisCacheConfiguration.defaultCacheConfig()
            .entryTtl(Duration.ofMinutes(5))
            .enableTimeToIdle();

        return RedisCacheManager.builder(connectionFactory)
            .cacheDefaults(defaults)
            .build();
    }
}

由于 Redis 服务器没有实现正确的 TTI 概念，因此只能通过接受过期选项的 Redis 命令来实现 TTI。在 Redis 中，“过期”在技术上是一种生存时间（TTL）策略。但是，在读取键的值时可以传递 TTL 过期，从而有效地重置 TTL 过期超时，就像现在 Spring Data Redis 的操作一样。Cache.get(key)spring-doc.cn

RedisCache.get(key)通过调用 Redis 命令实现。GETEXspring-doc.cn

Redis GETEX 命令仅在 Redis 版本及更高版本中可用。因此，如果您不使用 Redis 或更高版本，则无法使用 Spring Data Redis 的 TTI 过期。如果对不兼容的 Redis（服务器）版本启用 TTI，将引发命令执行异常。不会尝试确定 Redis 服务器版本是否正确并支持该命令。6.2.06.2.0GETEXspring-doc.cn

为了在 Spring Data Redis 应用程序中实现真正的空闲时间（TTI）过期行为，必须在每次读取或写入操作时都使用（TTL）过期来一致地访问条目。此规则没有例外。如果您在 Spring Data Redis 应用程序中混合和匹配不同的数据访问模式（例如：缓存、使用 and 可能调用操作，或者尤其是在使用 Spring Data Repository CRUD 操作时），则访问条目不一定会阻止条目过期（如果设置了 TTL 过期）。例如，在具有 TTL 过期（即）的服务方法调用期间，一个条目可能会“放入”（写入）缓存中，然后在过期超时之前使用 Spring Data Redis 存储库读取（使用不带过期选项）。未指定过期选项的 simple 不会重置条目的 TTL 过期超时。因此，该条目可能会在下一次数据访问操作之前过期，即使它刚刚被读取。由于无法在 Redis 服务器中强制执行此操作，因此您的应用程序有责任在配置空闲过期时间时，在缓存内外（如果适用）一致地访问条目。RedisTemplate@CacheableSET <expiration options>GETGETspring-doc.cn

Redis 缓存

Redis 缓存过期

生存时间 （TTL） 过期

空闲时间 （TTI） 过期

生存时间（TTL）过期

空闲时间（TTI）过期