排查java缓存泄漏的核心在于确认缓存对象是否被意外持有导致无法回收,通常通过检查gc roots引用链和使用内存分析工具(如mat)来定位。具体做法是导出堆转储文件(heap dump),在工具中构建缓存对象的dominator tree或reference chain,查看哪些非预期的变量或静态集合锁住了缓存数据。若发现缓存map的key/value未被正确移除,或监听器未注销,即可确认为泄漏点。

如何识别缓存中的异常增长
识别缓存泄漏的第一步是监控缓存的大小变化趋势。当缓存大小随时间线性增长且不出现下降拐点时,极大概率存在泄漏。可以通过实现`CacheListener`或在代码中定期打印缓存条目数,对比应用运行时长与缓存容量。如果使用的是Caffeine或Guava Cache,需特别注意是否配置了错误的过期策略或未启用软/弱引用,导致内存只增不减。

import com.github.benmanes.caffeine.cache.Caffeine;
import com.github.benmanes.caffeine.cache.Cache;
public class CacheLeakExample {
// 错误示例:未设置最大容量和过期时间,导致无限增长
private static final Cache<String, Object> BAD_CACHE = Caffeine.newBuilder()
.build();
public void addData(String key, Object value) {
BAD_CACHE.put(key, value);
}
public static void main(String[] args) throws InterruptedException {
for (int i = 0; i < 100000; i++) {
addData("key-" + i, new byte[1024 * 1024]); // 每个条目1MB
}
System.out.println("Cache Size: " + BAD_CACHE.estimatedSize());
// 输出将显示巨大的缓存大小,且不会自动清理
}
}
上述代码演示了一个典型的泄漏场景。由于没有调用`maximumSize()`或`expireAfterWrite()`,Caffeine会像普通HashMap一样存储所有放入的对象。随着循环执行,堆内存会被迅速填满,最终抛出OutOfMemoryError。正确的做法是显式限制容量或设置TTL。
立即学习“Java免费学习笔记(深入)”;
如何通过MAT定位缓存泄漏源
使用Eclipse MAT(Memory Analyzer Tool)可以直观地看到是谁“吃”掉了内存。打开堆转储文件后,选择“Histogram”视图,搜索你的缓存类名(如`com.github.benmanes.caffeine.cache.LocalCache`)。选中该类,右键点击“Path To GC Roots” -> “with excluded references”,排除掉正常的GC Root路径,查找那些不应该存在的强引用链。重点检查是否有静态集合、线程局部变量(ThreadLocal)或事件监听器持有了缓存中的Entry对象。

import java.util.HashMap;
import java.util.Map;
public class StaticCacheLeak {
// 静态Map作为缓存,生命周期伴随整个JVM,极易泄漏
private static final Map<String, String> CACHE = new HashMap<>();
public static void registerUser(String userId, String userData) {
CACHE.put(userId, userData);
}
public static void main(String[] args) {
// 模拟用户登录,不断添加数据但从未移除
for (int i = 0; i < 10000; i++) {
registerUser("user-" + i, "data-" + i);
}
// 此时CACHE持有大量不再需要的对象,形成泄漏
}
}
这个例子展示了静态集合导致的经典泄漏。在MAT中,你会发现`StaticCacheLeak$CACHE`字段直接指向HashMap实例,而HashMap又指向所有的Entry对象。由于静态字段是GC Root的一部分,这些Entry永远不会被回收。解决此问题应改用有界缓存或确保在业务逻辑结束时调用`remove()`方法。
缓存监听器未注销会导致什么后果
如果在缓存中注册了监听器(Listener)或刷新器(Remover),但未在适当时机注销,监听器内部持有的闭包或匿名类可能会间接持有缓存数据的引用,从而阻止垃圾回收。特别是在使用Guava Cache的`removalListener`时,如果监听器逻辑复杂且持有了外部大对象引用,即使缓存条目被移除,监听器本身仍可能通过引用链锁住相关内存。排查时需检查监听器的实现,确保其不持有对缓存键值对的强引用,或使用弱引用包装。


















