JAVA equals vs hashCode 차이와 함께 재정의하는 이유

🔗 equals 메서드란?

equals()는 자바에서 두 객체의 논리적 동등성(logical equality)을 비교하는 메서드입니다.
즉, 메모리 주소가 아닌 객체 내부의 값이 동일한지를 판단하죠.
Object 클래스에 정의되어 있는 equals()는 기본적으로 두 객체의 참조가 같은지를 비교하지만, 필요에 따라 오버라이딩하여 내용 기반 비교로 사용할 수 있습니다.

예를 들어 두 명의 학생(Student 객체)이 이름과 학번이 같다면 동일한 사람으로 간주할 수 있습니다.
이럴 경우 equals()를 재정의하여, 해당 속성들을 기준으로 비교하면 됩니다.

@Override
public boolean equals(Object obj) {
    if (this == obj) return true;
    if (obj == null || getClass() != obj.getClass()) return false;
    Student other = (Student) obj;
    return this.id.equals(other.id) && this.name.equals(other.name);
}

equals()는 주로 비교 연산, List의 contains(), remove() 메서드 등에서 사용됩니다.
적절히 오버라이딩하지 않으면 데이터 중복 판단이나 삭제 시 오류가 발생할 수 있어요.

단순히 == 연산자를 사용하는 경우는 두 객체가 같은 주소를 참조할 때만 true를 반환합니다.
그러나 실제 프로젝트에서는 대부분 값 기반 비교가 필요하기 때문에, equals()의 올바른 재정의가 핵심입니다.

🛠️ hashCode 메서드란?

hashCode()는 자바에서 객체를 정수형 해시값으로 변환하는 메서드입니다.
이 값은 주로 HashMap, HashSet, Hashtable 같은 해시 기반 자료구조에서 객체를 효율적으로 저장하고 검색하는 데 활용되죠.

Object 클래스의 기본 구현은 객체의 메모리 주소를 기반으로 해시값을 생성하지만, 우리가 equals()를 재정의했다면 hashCode()도 반드시 같이 재정의해줘야 합니다.
같은 값을 가진 객체는 같은 해시코드를 가져야만, 자료구조 내부에서 중복 여부나 위치를 올바르게 판단할 수 있기 때문이에요.

@Override
public int hashCode() {
    return Objects.hash(id, name);
}

위 예제처럼 java.util.Objects 클래스의 hash() 메서드를 활용하면 여러 필드를 조합한 해시코드를 쉽게 생성할 수 있습니다.
직접 곱셈과 덧셈으로 해시값을 계산하던 번거로운 방식보다 훨씬 안정적이고 간결하죠.

단, hashCode가 같다고 해서 equals()도 항상 true를 반환하는 건 아닙니다.
이는 충돌(collision)이라는 개념으로, 서로 다른 객체가 같은 해시값을 가질 수는 있지만 논리적으로 같다고 볼 수는 없다는 뜻이죠.

따라서 안정적인 해시코드를 생성하는 동시에, equals()와의 연계 규칙을 반드시 지켜야 합니다.

⚙️ equals와 hashCode는 왜 함께 재정의해야 하나?

equals()와 hashCode()는 논리적으로 같은 객체는 동일한 해시코드를 가져야 한다는 불변 규칙을 공유합니다.
이는 자바의 HashMap, HashSet 등 해시 기반 자료구조의 핵심 원리이기도 하죠.
equals()만 재정의하고 hashCode()를 그대로 두면, 객체가 논리적으로 같아도 해시코드가 다르기 때문에 동일 객체로 간주되지 않습니다.

예를 들어 같은 이름과 학번을 가진 두 학생 객체를 HashSet에 추가했다고 가정해볼게요.
equals()는 true를 반환하지만 hashCode()가 다르면, HashSet은 두 객체를 다른 값으로 저장합니다.
결과적으로 중복 제거가 안 되며, 예기치 않은 데이터 중복과 버그로 이어지죠.

💬 equals는 객체 비교 기준을 정의하고, hashCode는 객체의 위치를 찾아주는 열쇠 역할을 합니다.
둘은 항상 함께 재정의되어야 컬렉션에서 일관된 동작을 보장합니다.

• ✅equals가 true면 hashCode도 같아야 함
• ⚠️equals만 재정의하면 HashMap, HashSet에서 오작동 발생
• 💡항상 두 메서드는 쌍으로 재정의할 것

간단히 정리하자면, equals()와 hashCode()는 객체 비교와 컬렉션 사용의 핵심 규약입니다.
이 둘을 함께 재정의하지 않으면, 비교는 맞지만 검색이나 저장에서 치명적인 오류가 발생할 수 있으니 꼭 함께 다뤄야 합니다.

🔍 올바르게 equals, hashCode 구현하는 방법

equals()와 hashCode()는 자바 객체의 비교와 컬렉션 동작의 핵심이기 때문에, 정확하고 일관되게 구현하는 것이 매우 중요합니다.
잘못 구현하면 데이터 중복, 조회 실패, 삭제 오류 등 예측하기 힘든 문제가 발생하죠.

먼저 equals()는 다음 조건을 지켜야 합니다.

• 🟢반사성: x.equals(x)는 true여야 함
• 🔁대칭성: x.equals(y) == y.equals(x)
• 🔄추이성: x=y, y=z면 x=z
• 🧪일관성: 값이 변하지 않는 한 equals 결과도 변하면 안됨

hashCode()는 같은 객체에 대해 항상 같은 값을 반환해야 하며, equals()가 true인 경우에는 hashCode도 반드시 같아야 합니다.
이 규칙을 지키면 HashMap, HashSet 등의 자료구조에서 정확한 검색과 저장이 가능해집니다.

@Override
public boolean equals(Object obj) {
    if (this == obj) return true;
    if (obj == null || getClass() != obj.getClass()) return false;
    Member other = (Member) obj;
    return Objects.equals(id, other.id) && Objects.equals(name, other.name);
}

@Override
public int hashCode() {
    return Objects.hash(id, name);
}

올바른 구현은 단지 형식적인 것이 아니라, 자바 컬렉션의 동작을 보장하는 데 필수입니다.
특히 대규모 프로젝트나 협업 환경에서는 코드의 신뢰성과 유지보수를 위해 정확한 규약 준수가 중요합니다.

💡 실무에서 자주 발생하는 실수 사례

equals()와 hashCode()는 자바 개발자라면 꼭 이해하고 활용해야 할 핵심 메서드입니다.
하지만 실무에서는 여전히 많은 개발자들이 이 둘을 잘못 구현하거나 누락하는 경우가 많습니다.
그로 인해 HashMap에서 키가 안 맞거나, HashSet 중복이 발생하는 등 다양한 버그가 발생하죠.

📌 hashCode 재정의 누락

가장 흔한 실수는 equals()는 재정의했지만 hashCode()는 그대로 둔 경우입니다.
이럴 경우, 논리적으로 같은 객체라도 서로 다른 해시코드를 가지게 되어 HashMap에서 정상적으로 키를 찾을 수 없습니다.

📌 hashCode에 모든 필드 포함

hashCode를 만들 때 모든 필드를 포함하면 값이 자주 바뀌는 객체에서 문제가 됩니다.
예를 들어 사용자 객체의 접속시간 같은 값이 hashCode에 포함되면, 같은 객체라도 hashCode가 계속 바뀌게 되죠.
이럴 경우 컬렉션에서 조회 불가, 삭제 실패 같은 문제가 생깁니다.

📌 IDE 자동 생성 후 검토 누락

Eclipse나 IntelliJ 같은 IDE에서 equals와 hashCode를 자동 생성해주는 기능이 있지만, 모든 필드를 무조건 포함시키는 방식으로 만들어지기 때문에 개발자가 직접 검토해야 합니다.
불필요한 필드가 포함되거나, 중요한 필드가 누락되는 경우가 생길 수 있어요.

결국, equals와 hashCode의 재정의는 단순한 문법이 아니라, 논리적 설계와 자료구조 이해가 바탕이 되어야 올바르게 구현할 수 있습니다.

❓ 자주 묻는 질문 (FAQ)