@Order注解失效：JUnit测试执行顺序不符合预期

我正在测试自研JDBC库，流程是根据环境变量TESTDB指定的数据库名获取javax.sql.DataSource实例，再通过DataSource.getConnection()建立连接并执行SQL。需求是：

• 若环境中不存在TESTDB变量则跳过所有测试
• 分步测试初始化步骤（比如获取DataSource失败则跳过后续连接测试）

当前测试代码如下：

public static final String DBNAME = System.getenv("TESTDB");

private static DataSource DS = null;
private static Connection CONN = null;

@BeforeAll
public static void checkEnvironment() {
    assumeTrue(DBNAME != null, "Environment variable DBNAME");
    logger.info("DBNAME is {}", DBNAME);
}

@Test
@Order(20)
public void getDataSource() {
    DS = DatasourceFactory.getDataSourceByKey(DBNAME);
    assertNotNull(DS, "Failed to find details for datasource " +
        DBNAME);

    logger.info("Datasource for {}: {}", DBNAME, DS);
}

@Test
@Order(30)
public void getConnection() {
    try {
        CONN = DS.getConnection();
    } catch (SQLException e) {
        fail("Connetion to " + DBNAME + " failed", e);
    }
}

@BeforeAll工作正常，能正确跳过无TESTDB的场景，但添加@Order指定顺序后，getConnection()反而先于getDataSource()执行，导致静态变量DS为null触发空指针异常。

一、先排查@Order注解的有效性 #

1. 确认注解包导入正确

JUnit 5中负责测试方法排序的@Order必须来自org.junit.jupiter.api.Order，如果误导入了其他框架的Order注解（比如Spring的org.springframework.core.annotation.Order），排序逻辑完全不会生效。

检查代码顶部的导入语句，确保是：

import org.junit.jupiter.api.Order;

2. 区分JUnit版本

如果你的测试用的是JUnit 4，@Order注解根本不存在——JUnit 4的方法排序需要用@FixMethodOrder指定排序策略，比如：

import org.junit.FixMethodOrder;
import org.junit.runners.MethodSorters;

@FixMethodOrder(MethodSorters.NAME_ASCENDING)
public class YourTestClass {
    // 测试方法按名称字典序执行，可通过命名前缀（如test01_getDataSource）控制顺序
}

二、优化测试逻辑（避免静态变量依赖） #

用静态变量共享测试状态本身不是可靠的实践，容易引发并发问题或状态污染。推荐改用JUnit 5的@TestInstance(Lifecycle.PER_CLASS)让测试类仅实例化一次，用成员变量存储状态，同时配合Assumptions实现失败跳过后续测试：

import org.junit.jupiter.api.*;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.SQLException;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class JdbcLibraryTest {
    private final String dbName = System.getenv("TESTDB");
    private DataSource dataSource;
    private Connection connection;

    @BeforeAll
    void checkEnvironment() {
        Assumptions.assumeTrue(dbName != null, "环境变量TESTDB未设置，跳过所有测试");
        logger.info("当前测试数据库：{}", dbName);
    }

    @Test
    @Order(1)
    void getDataSourceSuccess() {
        dataSource = DatasourceFactory.getDataSourceByKey(dbName);
        Assertions.assertNotNull(dataSource, "获取数据源失败：" + dbName);
        logger.info("成功获取数据源：{}", dataSource);
    }

    @Test
    @Order(2)
    void getConnectionSuccess() {
        // 如果数据源未初始化，直接跳过该测试
        Assumptions.assumeNotNull(dataSource, "数据源未初始化，跳过连接测试");
        
        try {
            connection = dataSource.getConnection();
            Assertions.assertNotNull(connection, "连接实例为null");
        } catch (SQLException e) {
            Assertions.fail("数据库连接失败：" + dbName, e);
        }
    }

    @AfterAll
    void cleanUpResources() throws SQLException {
        if (connection != null && !connection.isClosed()) {
            connection.close();
        }
    }
}

三、额外注意点 #

• 如果开启了JUnit并行测试，@Order的排序会被忽略，需要在配置文件中关闭并行执行，或调整并行策略为单线程。
• 用Assumptions替代直接断言，可实现在前置条件不满足时跳过测试，而非标记为失败，更符合分步测试的需求。

内容的提问来源于stack exchange，提问作者Mikhail T.