求助：JUnit4断言泛型ArrayList时长数组内容被截断的解决办法

针对无头系统中，使用assertThat(generic1).isEqualTo(generic2)比较泛型类型（可能为超长ArrayList）时，JUnit输出被截断无法定位差异的问题，提供以下几种无需修改原有业务代码的解决方案：

方案1：捕获断言错误后手动打印完整集合内容 #

利用instanceof安全判断泛型是否为集合类型，在断言失败时打印所有元素，再重新抛出错误保留原有测试结果：

T a = returnArrayListGeneric();
T b = returnArrayListGeneric();

try {
    assertThat(a).isEqualTo(b);
} catch (AssertionError e) {
    // 仅当两者都是集合类型时打印完整内容
    if (a instanceof Collection<?> && b instanceof Collection<?>) {
        System.out.println("=== 实际集合内容 ===");
        ((Collection<?>) a).forEach(System.out::println);
        System.out.println("=== 期望集合内容 ===");
        ((Collection<?>) b).forEach(System.out::println);
    }
    throw e; // 不改变测试的失败状态
}

该方案兼容所有Collection实现类（包括ArrayList），无需指定具体泛型类型，避免强制转换风险。

方案2：通过系统属性调整AssertJ输出长度 #

如果使用的是AssertJ的assertThat（JUnit4中常用的断言库），可以通过设置系统属性取消元素截断：

方式A：测试代码中设置 #

在测试方法开头添加：

// 设置AssertJ集合输出无元素数量限制
System.setProperty("assertj.display.max_elements", "-1");

方式B：启动测试时添加JVM参数 #

在无头系统的测试启动命令中加入：

-Dassertj.display.max_elements=-1

设置后，AssertJ会输出集合的所有元素，无需修改原有断言逻辑。

方案3：自定义Hamcrest Matcher（若使用Hamcrest断言） #

如果使用的是Hamcrest原生的assertThat，可以自定义Matcher实现完整元素输出：

import org.hamcrest.Description;
import org.hamcrest.TypeSafeMatcher;
import java.util.Iterator;
import java.util.Objects;

public class FullIterableMatcher<T> extends TypeSafeMatcher<Iterable<T>> {
    private final Iterable<T> expected;

    public FullIterableMatcher(Iterable<T> expected) {
        this.expected = expected;
    }

    @Override
    protected boolean matchesSafely(Iterable<T> actual) {
        Iterator<T> actualIter = actual.iterator();
        Iterator<T> expectedIter = expected.iterator();
        while (actualIter.hasNext() && expectedIter.hasNext()) {
            if (!Objects.equals(actualIter.next(), expectedIter.next())) {
                return false;
            }
        }
        return !actualIter.hasNext() && !expectedIter.hasNext();
    }

    @Override
    public void describeTo(Description description) {
        description.appendValueList("[", ", ", "]", expected);
    }

    @Override
    protected void describeMismatchSafely(Iterable<T> actual, Description mismatchDescription) {
        mismatchDescription.appendText("实际内容为 ").appendValueList("[", ", ", "]", actual);
    }

    // 静态工厂方法简化调用
    public static <T> FullIterableMatcher<T> equalToFullIterable(Iterable<T> expected) {
        return new FullIterableMatcher<>(expected);
    }
}

使用时替换原有断言：

assertThat(a, equalToFullIterable(b));

自定义Matcher会在断言失败时输出完整的集合元素，不会截断。

内容的提问来源于stack exchange，提问作者Lucas W