Guava缓存未达maxSize与expireAfterWrite提前触发驱逐问题求助

针对你遇到的Guava缓存异常驱逐问题，结合配置和自定义加载逻辑，给出以下排查思路：

1. 先通过缓存统计定位驱逐原因 #

你已经配置了recordStats()，直接调用cache.stats()获取详细统计信息，重点关注：

• cache.size()：确认缓存实际存储的条目数是否真的只有1000，还是你的统计方式存在误差
• stats.evictionCount()和stats.evictionCause()：明确驱逐是因为SIZE（条目数接近上限）还是EXPIRED（过期）
  • 如果是EXPIRED：说明过期时间配置大概率存在错误
  • 如果是SIZE：说明实际缓存条目数已接近5000，只是你统计的key数量和缓存实际条目数不匹配

2. 检查过期时间配置的正确性 #

你代码里的expireAfterWrite(1h)是伪代码，实际Java代码必须指定时间单位，正确写法应为：

.expireAfterWrite(1, TimeUnit.HOURS)

如果不小心写成TimeUnit.MINUTES甚至TimeUnit.SECONDS，就会导致缓存提前过期，出现20分钟左右触发驱逐的情况，这是最常见的低级错误。

3. 排查自定义加载逻辑的潜在问题 #

你的加载流程用了锁和内部Map存储Future，可能存在以下问题：

• Future执行完成后，是否正确将结果写入Guava缓存？有没有遗漏或重复插入的情况？
• 内部Map中的Future是否在任务完成后及时清理？如果不清理，虽不会直接影响Guava缓存，但可能导致你对key数量的统计出错
• 锁的实现是否合理？比如是否用了ConcurrentHashMap的computeIfAbsent而非自定义锁？锁粒度不对可能导致多线程重复创建Future并插入缓存，使实际条目数远超预期

4. 确认缓存key的实现正确性 #

如果缓存key是自定义对象，必须正确实现equals()和hashCode()方法。若这两个方法实现错误，Guava会把逻辑上相同的key当成不同条目存储，导致缓存条目数快速增长到5000，触发SIZE驱逐。

5. 排查是否存在主动驱逐的代码 #

检查项目中是否有其他地方调用cache.invalidate(key)、cache.invalidateAll()等方法，主动移除缓存条目，导致你看到的“驱逐”其实是主动清理操作。

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