Spring Data GemFire Region条目TTL过期配置启动报错排查

这个异常的核心原因很明确：Apache Geode的过期策略（TTL/Idle Timeout）依赖Region的统计信息来跟踪条目的创建/访问时间，当目标Region的统计未启用时，设置过期规则就会触发IllegalStateException。

你的配置问题点 #

虽然你已经添加了@EnableStatistics注解，但这个注解的作用是启用GemFire全局的统计服务框架，而不是自动为所有Region开启统计功能。对于通过@EnableEntityDefinedRegions+实体类上@PartitionRegion创建的blockedIPCache Region，默认情况下统计是关闭的，这就导致了过期配置和统计状态的冲突。

具体修复方案 #

方案1：在实体类的Region注解中显式开启统计

直接修改你的BlockedIpEntityType类，在@PartitionRegion注解中添加enableStatistics = true属性：

@TimeToLiveExpiration(timeout = "100", action = "INVALIDATE")
@PartitionRegion(name = "blockedIPCache", enableStatistics = true)
class BlockedIpEntityType { ... }

这种方式精准针对单个实体对应的Region配置，适合只需要给特定Region开启统计的场景。

方案2：通过全局配置为所有实体定义的Region开启统计

如果你的应用中有多个实体定义的Region都需要启用统计，可以在GemFireConfiguration类中添加一个RegionConfigurer Bean，统一配置：

@PeerCacheApplication
@EnableGemfireCaching
@EnableCachingDefinedRegions(clientRegionShortcut = ClientRegionShortcut.LOCAL, serverRegionShortcut = RegionShortcut.LOCAL)
@EnableStatistics
@EnableExpiration
@EnableEntityDefinedRegions(basePackageClasses = {...})
@EnableGemfireRepositories(basePackages = {...})
class GemFireConfiguration {

    @Bean
    public RegionConfigurer entityRegionStatisticsConfigurer() {
        return (regionName, regionFactory) -> {
            // 为所有实体定义的Region开启统计
            regionFactory.setStatisticsEnabled(true);
        };
    }
}

这个Bean会在所有Region初始化时生效，自动开启统计功能，省去逐个实体配置的麻烦。

补充说明 #

• @EnableStatistics注解主要负责启用GemFire的统计收集服务，让系统能够收集和暴露统计数据，但每个Region的统计开关是独立控制的，必须显式开启才能让过期策略正常工作。
• 修复后，你通过Repository插入的BlockedIpEntityType对象会在100秒后触发INVALIDATE动作（条目失效，但不会从缓存中删除，下次访问会重新加载），符合你的预期。

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