讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

Java HashMap 为什么键要用不可变对象

夏芳同学_1513

夏芳同学_1513

发布时间:2026-11-21 12:12:13

|

640人浏览过

|

来源于php中文网

原创

java hashmap 要求键使用不可变对象,是因为其内部依赖 equals() 和 hashcode() 方法在对象生命周期内保持恒定。如果键是可变的且在存入 map 后状态发生改变,会导致 hashcode() 返回值变化,使得后续查找时无法定位到正确的桶位置,从而造成数据丢失或内存泄漏。

Java HashMap 为什么键要用不可变对象

可变键导致哈希冲突与查找失败

当使用可变对象作为键时,如果在插入 Map 之后修改了参与计算 hashCode() 的字段,该对象的哈希值就会改变。HashMap 在调用 get() 或 containsKey() 时,会使用当前对象的哈希值去计算桶索引。由于哈希值变了,计算出的索引可能与插入时的索引不同,导致 HashMap 认为该键不存在,即使它实际上就在表中。

Java HashMap 为什么键要用不可变对象

import java.util.HashMap;
import java.util.Map;

public class MutableKeyDemo {
    public static void main(String[] args) {
        // 定义一个简单的可变类
        class Key {
            int id;
            String name;
            
            Key(int id, String name) {
                this.id = id;
                this.name = name;
            }

            @Override
            public int hashCode() {
                // 哈希值基于 id 计算
                return Integer.hashCode(id);
            }

            @Override
            public boolean equals(Object o) {
                if (this == o) return true;
                if (!(o instanceof Key)) return false;
                Key key = (Key) o;
                return id == key.id;
            }
        }

        Map<Key, String> map = new HashMap<>();
        Key k = new Key(1, "Test");
        
        // 插入键值对
        map.put(k, "Value1");
        System.out.println("After put: " + map.get(k)); // 输出 Value1
        
        // 修改键的状态,导致 hashCode 改变
        k.id = 2;
        
        // 尝试获取,此时会返回 null
        System.out.println("After modify: " + map.get(k)); // 输出 null
        
        // 即使遍历,也找不到原来的键,因为它的哈希槽已经变了
        for (Map.Entry<Key, String> entry : map.entrySet()) {
            System.out.println("Entry: " + entry.getKey().id + " - " + entry.getValue());
        }
    }
}

运行上述代码,第一次 get(k) 能正常返回 "Value1",因为此时 k 的哈希值是 1,对应桶索引正确。但在将 k.id 修改为 2 后,k.hashCode() 变为 2。再次调用 map.get(k) 时,HashMap 会根据新的哈希值 2 去计算索引,而数据实际存储在哈希值为 1 的桶中,因此找不到数据,返回 null。更严重的是,原键对象仍然存在于 Map 的内部数组中,但由于其哈希值已变,我们无法再通过原引用访问它,这导致了潜在的内存泄漏。

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

FilePond 灵活的 JavaScript 文件上传库
FilePond 灵活的 JavaScript 文件上传库

FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

下载

为什么不可变对象能保证安全

不可变对象在其创建后,其状态不能被修改。这意味着参与 hashCode() 计算的字段值始终保持不变,从而保证了哈希值的稳定性。只要对象被放入 HashMap 后不再改变,无论经过多少次 get() 或 put() 操作,其所在的桶位置都不会发生变化,确保了数据的可检索性。

Java HashMap 为什么键要用不可变对象

import java.util.HashMap;
import java.util.Map;

public class ImmutableKeyDemo {
    public static void main(String[] args) {
        // 定义一个不可变类
        final class ImmutableKey {
            private final int id;
            private final String name;
            
            ImmutableKey(int id, String name) {
                this.id = id;
                this.name = name;
            }

            public int getId() { return id; }
            public String getName() { return name; }

            @Override
            public int hashCode() {
                return Integer.hashCode(id);
            }

            @Override
            public boolean equals(Object o) {
                if (this == o) return true;
                if (!(o instanceof ImmutableKey)) return false;
                ImmutableKey that = (ImmutableKey) o;
                return id == that.id;
            }
        }

        Map<ImmutableKey, String> map = new HashMap<>();
        ImmutableKey ik = new ImmutableKey(1, "Safe");
        
        // 插入键值对
        map.put(ik, "Value1");
        System.out.println("Get before: " + map.get(ik)); // 输出 Value1
        
        // 注意:这里不能修改 ik 的状态,因为它是 final 的
        // 如果我们试图创建一个新的对象来模拟“修改”,那其实是另一个对象
        ImmutableKey ikNew = new ImmutableKey(1, "Safe");
        System.out.println("Get with new instance: " + map.get(ikNew)); // 输出 Value1
    }
}

在不可变对象的示例中,ImmutableKey 的所有字段都是 final 的,且没有提供修改器(setter)。一旦对象创建,其 id 和 name 就固定下来。即使我们创建了一个内容相同的新对象 ikNew,由于 equals() 方法基于 id 进行比较,且 hashCode() 也基于 id,HashMap 能够正确地通过 ikNew 找到之前存入的值。这证明了不可变性是保证 HashMap 行为一致性的关键。

具体场景:自定义对象作为键时的注意事项

在实际开发中,我们经常需要自定义对象作为 HashMap 的键。此时必须确保该类是不可变的,或者至少保证参与 hashCode() 和 equals() 计算的字段是不可变的。如果这些字段是可变的,并且可能在对象放入 Map 后被修改,就会引发上述问题。此外,即使对象本身是不可变的,如果其包含的可变成员对象(如数组、List)被修改,也可能影响 equals() 和 hashCode() 的结果,因此需要深拷贝或使用其他不可变集合来包装这些成员。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
java
java

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

13097

2023.06.15

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

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

10142

2023.07.05

java自学难吗
java自学难吗

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

8592

2023.07.31

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

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

1364

2023.08.01

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

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

1088

2023.08.02

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

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

1636

2023.08.02

java有什么用
java有什么用

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

3429

2023.08.02

java在线网站
java在线网站

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

20651

2023.08.03

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn