如何配置AssertJ递归比较实现列表的精准差异提示？

可以通过配置递归比较的集合处理策略，实现和直接列表比较一致的精准差异提示，无需拆分断言步骤。

核心方案：指定标准集合比较策略 #

AssertJ的递归比较默认对集合仅做大小校验和逐元素递归比对，当大小不一致时仅提示尺寸差异。我们可以通过withCollectionComparator方法，替换为AssertJ直接比较列表时使用的标准集合比较策略，从而让嵌套列表的差异提示包含具体的多余/缺失元素。

代码示例 #

假设我们有嵌套列表的业务对象：

class OrderBatch {
    private String batchId;
    private List<OrderItem> items;
    // Getters & Setters
}

class OrderItem {
    private String sku;
    private int quantity;
    // Getters & Setters
}

原来的递归比较（仅提示大小差异）：

assertThat(actualBatch).usingRecursiveComparison().isEqualTo(expectedBatch);

修改后的递归比较（显示具体元素差异）：

import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.util.ComparatorUtils.standardComparisonStrategy;

// ...

assertThat(actualBatch)
    .usingRecursiveComparison()
    // 替换为标准集合比较策略，与直接列表比较逻辑一致
    .withCollectionComparator(standardComparisonStrategy().collectionComparator())
    .isEqualTo(expectedBatch);

针对特定集合类型配置 #

如果只需要对特定类型的嵌套列表启用该策略，可以使用withCollectionComparatorForType：

assertThat(actualBatch)
    .usingRecursiveComparison()
    // 仅对List类型应用标准比较策略
    .withCollectionComparatorForType(standardComparisonStrategy().collectionComparator(), List.class)
    .isEqualTo(expectedBatch);

效果验证 #

配置后，当嵌套列表存在大小差异时，断言失败提示会和直接比较列表一致，例如：

Expected size: 3 but was: 4 in field 'items'
Expected elements: [OrderItem{sku='A', quantity=2}, OrderItem{sku='B', quantity=1}, OrderItem{sku='C', quantity=3}]
Actual elements: [OrderItem{sku='A', quantity=2}, OrderItem{sku='B', quantity=1}, OrderItem{sku='C', quantity=3}, OrderItem{sku='D', quantity=1}]

这样就能在复杂嵌套对象的断言中，直接获取精准的元素差异信息，无需拆分单独对列表做断言。

内容的提问来源于stack exchange，提问作者Bogdan Calmac