Java 为什么重写 `equals` 时必须同时重写 `hashCode` 方法

秋磊小哥_8685

秋磊小哥_8685

2026-09-07

451人浏览

原创

必须同时重写equals和hashcode方法,否则会导致hashmap、hashset等哈希容器查找不到、存不进、去重失效;因哈希容器先用hashcode定位桶,再用equals精确比较,若equals为true但hashcode不同,对象会被散列到不同桶中。

java 为什么重写 `equals` 时必须同时重写 `hashcode` 方法

因为 Java 集合(比如 HashMap、HashSet)依赖 hashCode 快速定位对象位置,再用 equals 精确判断是否重复;如果只重写 equals 而不重写 hashCode,逻辑上相等的对象可能被散列到不同桶中,导致查不到、存不进、去重失效。

哈希容器的工作机制决定二者必须一致

当对象作为 key 存入 HashMap 或加入 HashSet 时:

  • JVM 先调用 hashCode(),算出它该放进哪个“桶”(数组索引)
  • 只在那个桶里,才逐个调用 equals() 判断是否真正相等
  • 如果两个对象 a.equals(b) == true,但 a.hashCode() != b.hashCode(),它们就会被分到不同桶中——后续 map.get(b) 或 set.contains(b) 永远找不到 a

违反 Java 规范契约会引发静默故障

Java 明确要求:只要 equals 返回 true,hashCode 就必须返回相同值。这不是建议,而是强制契约。违反后不会报错,但会出现:

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载
  • HashSet 允许存入两个 equals 为 true 的对象 → 本该去重却重复了
  • HashMap 中用新构造的等价 key 调用 get() 返回 null → 数据明明存在却取不到
  • ConcurrentHashMap 或 LinkedHashSet 同样行为异常,底层仍依赖哈希定位

重写时的关键实操原则

确保二者逻辑同步,避免手误或遗漏:

  • 参与 equals 比较的字段,必须全部用于 hashCode 计算(例如只比 id,就只用 id;若还加了 name 和 email,哈希也得包含这三者)
  • 推荐用 Objects.hash(f1, f2, f3),自动处理 null 和类型转换,比手写更安全
  • 避免使用可变字段(如后期会修改的 status)参与哈希计算,否则对象入集合后再改字段,哈希值变化 → 永远取不出来
  • 继承场景下,子类若扩展了 equals 判定字段,不仅要重写自己的 hashCode,还要确认父类已正确实现

不重写的典型反例

假设 Person 类只重写了 equals(按 name 和 age 判断),但没动 hashCode:

  • p1 = new Person("Alice", 25),p2 = new Person("Alice", 25)
  • p1.equals(p2) 返回 true,但 p1.hashCode() == p2.hashCode() 很可能是 false(因用的是 Object 默认实现)
  • Set<person> set = new HashSet(); set.add(p1); set.contains(p2)</person> 返回 false —— 本该是 true

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

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

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

2023.06.15

9937

6

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

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

2023.07.05

7062

9

java自学难吗
java自学难吗

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

2023.07.31

6232

8

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

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

2023.08.01

1084

3

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

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

2023.08.02

888

3

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

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

2023.08.02

1296

5

java有什么用
java有什么用

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

2023.08.02

2609

5

java在线网站
java在线网站

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

2023.08.03

19931

3

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

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

2023.08.03

1175

8

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习