AssertJ递归比较在Spring Boot升级后失效问题解析

问题背景

在Spring Boot从2.7.18升级到3.2.1版本后，使用AssertJ的递归比较功能时出现了测试失败的情况。具体表现为当比较包含ReentrantLock类型字段的对象时，即使对象内容相同，测试也会因为锁实例不同而失败。

技术细节分析

1. 递归比较机制变化：

   • AssertJ 3.24.2版本对递归比较进行了增强
   • Java 17对反射访问JRE类型(如java.util.concurrent.locks.ReentrantLock)进行了限制
   • 对于JRE类型，AssertJ现在会直接调用equals()方法而非使用反射比较字段

2. 典型错误场景： 当比较包含锁对象的复杂对象时，如Spring Batch的RepositoryItemReader，即使业务字段完全相同，测试也会因为锁实例不同而失败。

3. 解决方案：

   • 忽略锁类型字段：使用ignoringFieldsOfTypes(ReentrantLock.class)
   • 自定义比较器：为特定字段或类型注册BiPredicate比较器
   • 升级AssertJ：新版提供了ignoringFieldsOfTypesMatchingRegexes()方法

最佳实践建议

1. 避免比较非业务字段： 测试时应专注于业务相关字段的比较，而非框架内部实现细节如锁机制。

2. 合理使用递归比较：

   • 对于包含JRE类型的复杂对象，明确指定比较策略
   • 考虑只比较对象的内容而非整个对象结构

3. 测试设计建议：

   • 对于数据访问层测试，更推荐比较实际数据而非Reader对象本身
   • 对于必须比较复杂对象的场景，明确指定比较策略和忽略规则

总结

AssertJ的递归比较功能在Java 17环境下对JRE类型的处理方式发生了变化，这要求开发者更明确地指定比较策略。通过合理配置比较规则，可以确保测试既准确又稳定，不受框架内部实现细节的影响。理解这一机制变化有助于编写更健壮的测试代码，特别是在Spring Boot升级后的兼容性保障方面。