如何配置AssertJ或通过JUnit @After确保所有Assert对象执行实际断言？

这个问题问到点子上了！很多人写AssertJ测试时都不小心犯过这种“只调用assertThat却没加实际断言”的错误，下面给你几个实用的解决方案：

一、AssertJ原生支持的方案（最推荐） #

其实AssertJ本身就内置了未完成断言的检测机制，只是默认是关闭的。你只需要简单配置就能开启“未完成断言即失败”的规则：

方式1：代码中全局配置 #

在你的测试基类里添加@BeforeAll方法来全局禁用未完成断言：

import org.junit.jupiter.api.BeforeAll;
import static org.assertj.core.api.Assertions.setAllowUnfinishedAssertions;

public class BaseTest {
    @BeforeAll
    static void setUpAssertJ() {
        // 设置为false后，任何只调用assertThat()却没执行实际断言的测试都会直接失败
        setAllowUnfinishedAssertions(false);
    }
}

所有测试类继承这个基类即可生效。

方式2：JVM参数配置 #

如果不想改代码，可以直接给测试运行器添加JVM参数：

-Dorg.assertj.core.unfinished.assertions.fail=true

这样整个测试套件都会自动检测未完成的断言。

二、自定义跟踪方案（适合特殊需求） #

如果原生配置满足不了你的个性化需求（比如想自定义失败提示、排除某些辅助方法的检测），可以用你提到的代理思路，但可以简化实现：

1. 先写一个自定义的断言工具类，返回代理对象并跟踪断言调用：

import org.assertj.core.api.AbstractAssert;
import org.assertj.core.api.Assertions;
import java.lang.reflect.Proxy;

public class TrackedAssertions {
    public static <T> AbstractAssert<?, T> assertThat(T actual) {
        AbstractAssert<?, T> delegate = Assertions.assertThat(actual);
        // 生成代理对象，跟踪实际断言方法的调用
        return (AbstractAssert<?, T>) Proxy.newProxyInstance(
            delegate.getClass().getClassLoader(),
            delegate.getClass().getInterfaces(),
            (proxy, method, args) -> {
                // 排除as、withFailMessage这类辅助方法，只标记实际断言方法
                if (!method.getName().matches("as|withFailMessage|describedAs")) {
                    AssertionTracker.markAssertionExecuted();
                }
                return method.invoke(delegate, args);
            }
        );
    }
}

2. 再写一个跟踪器，用@AfterEach来检测是否有未完成的断言：

import org.junit.jupiter.api.AfterEach;

public class AssertionTracker {
    // 用ThreadLocal保证线程安全，避免测试间干扰
    private static final ThreadLocal<Boolean> ASSERTION_EXECUTED = ThreadLocal.withInitial(() -> false);

    public static void markAssertionExecuted() {
        ASSERTION_EXECUTED.set(true);
    }

    @AfterEach
    void checkUnfinishedAssertions() {
        if (!ASSERTION_EXECUTED.get()) {
            throw new AssertionError("测试仅调用了assertThat()，未执行任何实际断言！");
        }
        // 重置状态，避免影响下一个测试
        ASSERTION_EXECUTED.set(false);
    }
}

3. 测试类继承AssertionTracker，并使用TrackedAssertions.assertThat即可：

import static com.yourpackage.TrackedAssertions.assertThat;
import org.junit.jupiter.api.Test;

public class YourTest extends AssertionTracker {
    @Test
    void unfinishedAssertion() {
        assertThat("str"); // 这个测试会触发AssertionError，符合预期
    }

    @Test
    void validAssertion() {
        assertThat("str").isEqualTo("str"); // 正常通过
    }
}

总结 #

优先用AssertJ原生的配置方案，简洁且无额外代码侵入；自定义方案只在需要特殊规则时使用。

内容的提问来源于stack exchange，提问作者Ivan G.