JUnit5类级并发执行模式为何影响其他无关测试类？

根本原因 #

你对JUnit 5并行执行模型的理解存在偏差：当junit.jupiter.execution.parallel.enabled=true时，整个测试套件的所有测试类/方法都会进入线程池调度。默认的ExecutionMode.SAME_THREAD（原顺序执行逻辑）仅保证同一个测试类内部的方法在同一个线程执行，但不同测试类之间（比如你的并发测试类和依赖Exposed Mock的测试类）会被分配到不同线程同时运行。

而Mockk的mockkObject是对全局静态类的Mock，本身不具备线程隔离特性：

• 当依赖Mock的测试线程还未完成Mock初始化，或者测试结束后清理了Mock状态，此时并发测试线程触发Exposed的静态调用，就会抛出Please call Database.connect() before using this code错误；
• 即使两个测试线程同时操作Mock，也会互相覆盖Mock行为，导致预设的Mock逻辑失效。

这不是JUnit的Bug，而是对并行模型和静态Mock特性的适配问题。

解决方案 #

1. 给敏感测试添加资源锁，强制串行执行 #

给所有依赖Exposed Mock的测试类添加@ResourceLock注解，JUnit会确保标记了同一资源锁的测试不会并行执行，彻底避免Mock冲突：

import org.junit.jupiter.api.parallel.ResourceLock

// 自定义资源名，确保所有敏感测试使用同一锁标识
@ResourceLock("ExposedStaticResources")
class ExposedDependentTest {
    // 测试方法
}

同时保留junit.jupiter.execution.parallel.enabled=true，给不需要Mock的测试类/方法添加@Execution(ExecutionMode.CONCURRENT)即可。

2. 严格Mock的初始化与清理逻辑 #

在自定义扩展的AfterEachCallback中，确保完全清理Mock状态，避免残留到其他测试线程：

private fun unmockExposedTransaction() {
    unmockkObject(Database)
    unmockkObject(TransactionManager)
    clearAllMocks(answers = false) // 重置所有Mock的应答逻辑
}

如果使用Mockk 1.13及以上版本，可以改用threadLocalMockkObject创建线程绑定的静态Mock，确保每个线程的Mock独立：

// 初始化线程绑定的Mock
threadLocalMockkObject(Database)
every { Database.connect(datasource) } answers { database }

// 清理时使用对应方法
threadLocalUnmockkObject(Database)

3. 隔离敏感测试类 #

给依赖Exposed Mock的测试类添加@Isolated注解，JUnit会单独运行这些测试，不与其他测试并行：

import org.junit.jupiter.api.Isolated

@Isolated
class ExposedDependentTest {
    // 测试方法
}

该方案会牺牲部分并行效率，但能彻底避免线程干扰，适合对稳定性要求极高的敏感测试。

总结 #

不需要给JUnit 5提交Bug，问题源于对并行模型的误解和静态Mock的线程不安全特性。优先尝试资源锁+严格Mock清理的方案，既能保留大部分测试的并行能力，又能避免敏感测试的冲突。

内容的提问来源于stack exchange，提问作者Vincent F