0

0

Java中的WeakHashMap应用场景_缓存设计与内存泄漏防范

P粉602998670

P粉602998670

发布时间:2026-03-12 11:54:53

|

200人浏览过

|

来源于php中文网

原创

weakhashmap 不阻止 key 被 gc 因其 key 用 weakreference 包装,无强引用时 gc 可回收;但 value 仍被强引用,若 value 反向引用 key 会导致内存泄漏,且清理惰性、非线程安全。

java中的weakhashmap应用场景_缓存设计与内存泄漏防范

WeakHashMap 为什么不会阻止 key 被 GC 回收

因为 WeakHashMap 内部用的是 WeakReference 包装 key,只要没有强引用指向该 key,下一次 GC 就可能把它清掉——value 是否还被引用不影响这个过程。这点和 HashMap 完全不同,后者会让 key 和 value 都一直留在堆里,直到 map 自身被回收。

常见错误现象:WeakHashMap 突然“变空”或查不到刚 put 进去的值,其实不是 bug,而是 key 对象(比如临时创建的 String、局部 new Object())很快被 GC 了。

  • 使用场景:适合缓存“附属信息”,比如为某个对象动态附加元数据,且不希望因此延长其生命周期
  • key 必须是可被 GC 的普通对象;不能用常量字符串(如 "abc")做 key,因为字符串常量池里的对象永远不会被回收
  • value 仍会被强引用住,如果 value 又反向引用了 key 或其他大对象,照样引发内存泄漏

WeakHashMap 做缓存时必须配合引用队列清理 stale entry

WeakHashMap 不会立刻删除已失效的 entry,而是在每次调用 getputsize 等方法时,顺手清理一部分。但这个清理是懒惰且不彻底的——如果长时间只读不写,失效 entry 会堆积,导致 size() 返回值虚高、内存实际没释放。

真实问题:缓存长期运行后发现 WeakHashMap.size() 越来越大,但实际有效 entry 很少。

立即学习Java免费学习笔记(深入)”;

智川X-Agent
智川X-Agent

中科闻歌推出的一站式AI智能体开发平台

下载
  • 必须手动触发清理:在关键路径后调用 expungeStaleEntries()(它是 package-private,得用反射或继承绕过)
  • 更稳妥的做法是别直接用 WeakHashMap,改用 java.lang.ref.ReferenceQueue + WeakReference 自建结构,或选用 Guava Cache / Caffeine,它们内置了及时清理逻辑
  • 注意 expungeStaleEntries() 是同步方法,高频调用会影响性能

WeakHashMap 无法解决 value 引用 key 导致的循环引用泄漏

很多人以为用了 WeakHashMap 就万事大吉,结果发现对象还是不被回收。典型原因是 value 持有对 key 的强引用(比如 value 是个内部类实例、或显式保存了 key 的引用),形成“key → value → key”闭环。

错误示例:

map.put(obj, new Wrapper(obj)); // Wrapper 内部持有 obj 引用

  • GC 判断的是“从 GC Roots 是否可达”,只要 value 还活着,它持有的 key 就算被 WeakHashMap 弱引用也照旧活得好好的
  • 检查泄漏时,用 MAT 或 VisualVM 看对象的支配树(dominator tree),重点找 value 到 key 的强引用链
  • 解决方案不是换 map,而是让 value 改用 WeakReference<k></k> 存 key,或者干脆避免这种双向绑定设计

WeakHashMap 在多线程环境下不安全,但并发清理逻辑更危险

WeakHashMap 本身不是线程安全的,这点和 HashMap 一样。但它额外有个坑:内部的 ReferenceQueue 清理逻辑在多线程并发调用 get/put 时,可能触发 Entry 数组的并发修改,导致 ConcurrentModificationException 或静默数据丢失。

  • 不要给 WeakHashMapsynchronized 块就认为安全了——清理动作本身不在锁保护范围内
  • 高并发场景下,优先考虑 ConcurrentHashMap + 定期扫描 key 弱引用状态,或直接上 Caffeine.newBuilder().weakKeys().build()
  • 哪怕单线程,如果 key 是跨线程共享的对象(比如被多个线程同时作为 key 使用),也要小心 GC 时机不可控带来的行为漂移

WeakHashMap 的边界很窄:它只解决“key 生命周期不该由 map 维持”这一个问题。一旦涉及 value 生命周期管理、并发访问、或需要精确控制回收时机,就得跳出这个类本身去设计——否则省下的几行代码,最后花几天 debug 都补不回来。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
guava包作用
guava包作用

guava是一个java库,增强了java标准库,提供更有效率和易于使用的集合、实用程序、缓存和并发工具。想了解更多guava的相关内容,可以阅读本专题下面的文章。

271

2024.05.29

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1010

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串常量的表示方法
字符串常量的表示方法

字符串常量的表示方法:1、使用引号;2、转义字符;3、多行字符串;4、原始字符串;5、字符串连接;6、字符串字面量和对象;7、编码问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

143

2023.12.26

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.3万人学习

C# 教程
C# 教程

共94课时 | 11.1万人学习

Java 教程
Java 教程

共578课时 | 80.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号