AssertJ递归比较中的Lazy字段加载问题解析

AssertJ是一个流行的Java测试断言库，其递归比较功能(usingRecursiveComparison)在测试中非常实用。然而，在实际使用中，特别是与JPA实体结合时，开发者可能会遇到一个棘手的问题：即使指定了只比较特定字段(comparingOnlyFields)，递归比较仍然会加载所有字段值，包括标记为LAZY加载的关联字段。

问题背景

当使用JPA实体进行测试时，我们经常需要比较实体的部分字段。例如，一个User实体可能包含基本字段如id、name，以及关联字段如city(标记为FetchType.LAZY)。理想情况下，我们期望只比较指定的字段而不触发其他字段的加载。

assertThat(myEntity)
    .usingRecursiveComparison()
    .comparingOnlyFields("name", "id")
    .isEqualsTo(dto);

然而，在AssertJ 3.24.2版本中，即使指定了comparingOnlyFields，递归比较仍然会尝试访问所有字段的值，导致LazyInitializationException异常被抛出。

问题根源分析

深入分析问题，我们发现根本原因在于递归比较的内部实现机制：

1. 字段收集阶段：首先收集所有可能的字段节点名称
2. 过滤阶段：根据配置过滤掉不需要比较的字段
3. 值获取阶段：为每个需要比较的字段创建DualValue对象

问题出在DualValue对象的hashCode计算上。在旧版本中，DualValue的hashCode方法使用了字段值进行计算，当这些值涉及LAZY加载的关联时，就会触发JPA的延迟加载机制。

解决方案

AssertJ团队在3.26.3版本中修复了这个问题。修复的核心思路是：

1. 优化hashCode计算：不再使用字段值计算hashCode，而是仅基于字段位置信息
2. 延迟值访问：确保在真正需要比较时才访问字段值

开发者可以通过以下方式升级：

对于使用Spring Boot的项目，可以在pom.xml中配置assertj.version属性：

<properties>
    <assertj.version>3.26.3</assertj.version>
</properties>

或者显式排除Spring Boot管理的版本并引入新版：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>org.assertj</groupId>
            <artifactId>assertj-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<dependency>
    <groupId>org.assertj</groupId>
    <artifactId>assertj-core</artifactId>
    <version>3.26.3</version>
    <scope>test</scope>
</dependency>

最佳实践

在使用AssertJ进行JPA实体测试时，建议：

1. 始终使用最新稳定版的AssertJ
2. 明确指定需要比较的字段，避免不必要的字段访问
3. 对于复杂实体结构，考虑使用DTO模式进行测试
4. 在集成测试中注意事务边界，确保LAZY加载在需要时可用

通过理解这一问题的本质和解决方案，开发者可以更有效地利用AssertJ的强大功能进行JPA实体测试，同时避免常见的延迟加载陷阱。