如何修复JUnit测试中的java.lang.AssertionError错误？

执行JUnit单元测试时触发java.lang.AssertionError，错误发生在test.ContactManagerTest.contactAdded方法中，测试目的是验证ContactManager是否包含已添加的Contact实例，测试代码如下：

package test;

import models.ContactManager;
import models.Contact;

import static org.junit.Assert.*;

import java.text.ParseException;

import org.junit.Before;
import org.junit.Test;

public class ContactManagerTest {
    ContactManager contactManager;

    @Before
    public void setup() throws ParseException {
        contactManager = new ContactManager();
        contactManager.addContact(new Contact("Rita", "5556036071", "6700 Lincoln Ave", "Thumbtack", "07/15/2023" ));
        contactManager.addContact(new Contact("Alex", "3236063206", "6700 Lincoln Ave", "Thumbtack", "09/15/2023" ));
    }
    
    @Test
    public void contactAdded() throws ParseException {
       assertTrue(contactManager.contains(new Contact("Rita", "5556036071", "6700 Lincoln Ave", "Thumbtack", "07/15/2023")));
    }
    
}

问题原因与解决方案 #

核心问题 #

你在测试中创建了一个全新的Contact实例，即便它的所有属性和之前添加的实例完全一致，Java默认会通过对象内存地址判断相等性——这两个是不同的对象，所以contactManager.contains()返回false，触发断言失败。

解决步骤 #

1. 重写Contact类的equals()和hashCode()方法
   基于业务逻辑中唯一标识联系人的字段（比如姓名+电话）来实现相等判断，示例代码如下：

   import java.util.Objects;
   
   public class Contact {
       private String name;
       private String phoneNumber;
       private String address;
       private String company;
       private String date;
   
       // 构造方法、getter/setter省略
   
       @Override
       public boolean equals(Object o) {
           if (this == o) return true;
           if (o == null || getClass() != o.getClass()) return false;
           Contact contact = (Contact) o;
           return Objects.equals(name, contact.name) && Objects.equals(phoneNumber, contact.phoneNumber);
       }
   
       @Override
       public int hashCode() {
           return Objects.hash(name, phoneNumber);
       }
   }
   

   注意：equals和hashCode必须保持逻辑一致——如果两个对象equals返回true，它们的hashCode必须相等。

2. 确认ContactManager的contains逻辑
   如果ContactManager是用标准集合（比如ArrayList）存储联系人，集合的contains方法默认会调用元素的equals()方法，无需额外修改；如果是自定义的判断逻辑，要确保它依赖equals()而不是内存地址。

简化方案（Java 17+） #

如果使用Java 17或更高版本，可以将Contact定义为record类，它会自动生成符合规范的equals()和hashCode()方法，代码更简洁：

public record Contact(String name, String phoneNumber, String address, String company, String date) {}

内容的提问来源于stack exchange，提问作者Margarita Kattsyna