如何在 Java 中利用 WeakHashMap 实现一个当键不再被强引用时自动回收的临时缓存

梦磊同学_9208

梦磊同学_9208

2026-05-01

364人浏览

原创

WeakHashMap能自动清理是因为其键使用弱引用,GC回收无强引用的键后,通过expungeStaleEntries()在后续操作中扫描并移除对应条目。

如何在 java 中利用 weakhashmap 实现一个当键不再被强引用时自动回收的临时缓存

WeakHashMap 适合做临时缓存,核心在于它的键是弱引用(WeakReference),当键对象没有其他强引用指向它时,GC 可以回收该键,随后对应的键值对会在下一次哈希表清理时自动被移除。

为什么 WeakHashMap 能自动清理?

WeakHashMap 内部使用一个 弱引用的键数组,其 Entry 继承自 WeakReference<k></k>。这意味着: - 键对象只被 WeakReference 持有,不阻止 GC; - 当 GC 回收了某个键实例,对应 Entry 的 get() 返回 null; - 下次调用 size()、get()、put() 等方法时,WeakHashMap 会扫描并清理这些“已失效”的 Entry(通过 expungeStaleEntries())。

⚠️ 注意:值对象仍是强引用!如果值也持有键的强引用(如循环引用),或值本身很大,需手动管理值的生命周期,否则可能造成内存泄漏。

构建安全的临时缓存类

直接用 WeakHashMap 做缓存容易忽略两点:值未及时释放、缺乏过期控制。推荐封装一层:

  • 用 WeakHashMap<k cachevalue>></k> 存储,其中 CacheValue 包含实际值 + 创建时间;
  • 每次 get() 时检查是否过期(可选),并触发清理;
  • 避免在值中强引用键(例如不要在 value 里存 this 或外部 this 引用);
  • 若需更精细控制(如 LRU、最大容量、定时淘汰),建议改用 java.util.concurrent.ConcurrentHashMap + 引用队列 + 定时线程,或直接用 Caffeine。

简单示例:带超时的弱键缓存

// 示例:缓存用户配置,键是 User 实例,无强引用时自动失效

JavaStoryDevelop
JavaStoryDevelop

你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在

下载
public class WeakTimeoutCache<k v> {
    private final WeakHashMap<k cacheentry>> cache = new WeakHashMap();
    private final long timeoutMs;
<pre class="brush:php;toolbar:false;">public WeakTimeoutCache(long timeoutMs) {
    this.timeoutMs = timeoutMs;
}

public void put(K key, V value) {
    cache.put(key, new CacheEntry(value));
}

public V get(K key) {
    CacheEntry<v> entry = cache.get(key);
    if (entry == null || entry.isExpired(timeoutMs)) {
        cache.remove(key); // 主动清理过期项(非必须,但更及时)
        return null;
    }
    return entry.value;
}

private static class CacheEntry<v> {
    final V value;
    final long createTime;

    CacheEntry(V value) {
        this.value = value;
        this.createTime = System.currentTimeMillis();
    }

    boolean isExpired(long timeoutMs) {
        return System.currentTimeMillis() - createTime > timeoutMs;
    }
}</v></v>

}

使用时只需确保传入的 key(如 new User(123))不被其他地方长期强引用,一旦不可达,下次 GC 后再调用 get() 就返回 null。

常见陷阱与建议

  • 键必须重写 equals() 和 hashCode():WeakHashMap 仍依赖哈希逻辑定位 Entry,若没正确实现,get() 找不到值;
  • 不要用 String、Integer 等常量池对象作键:它们被 JVM 强引用,永远不会被回收,WeakHashMap 失去意义;
  • 不适用于长期稳定缓存:弱引用不可控,GC 时间不确定,不适合要求“至少存活 X 分钟”的场景;
  • 并发访问需额外同步:WeakHashMap 本身非线程安全,多线程下应包装为 Collections.synchronizedMap() 或改用其他方案。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10837

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7962

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6912

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1164

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

948

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1416

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2849

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20151

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1255

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习