JUnit5测试中能否修改/过滤classpath？替代JUnit4自定义Runner方案

针对你的SWT GUI测试场景——需要排除不匹配当前平台的SWT库，JUnit5确实提供了解决方案，不过和JUnit4的自定义Runner思路不同，它的扩展模型（Extension Model）更模块化，下面是几种可行的方案：

1. 优先推荐：构建工具层面过滤（最简洁） #

其实不需要在测试代码里做手脚，直接在Maven/Gradle这类构建工具中根据当前运行平台自动过滤SWT依赖，这是最省心的方案：

Maven示例 #

利用os-maven-plugin自动识别当前操作系统，结合Profile激活来排除无关平台的SWT依赖：

<build>
  <plugins>
    <plugin>
      <groupId>kr.motd.maven</groupId>
      <artifactId>os-maven-plugin</artifactId>
      <version>1.7.0</version>
      <executions>
        <execution>
          <phase>initialize</phase>
          <goals>
            <goal>detect</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

<profiles>
  <!-- Windows平台排除其他SWT依赖 -->
  <profile>
    <id>windows</id>
    <activation>
      <os>
        <family>windows</family>
      </os>
    </activation>
    <dependencies>
      <dependency>
        <groupId>org.eclipse.swt</groupId>
        <artifactId>org.eclipse.swt.win32.win32.x86_64</artifactId>
        <version>4.26</version>
        <scope>test</scope>
      </dependency>
    </dependencies>
  </profile>
  <!-- macOS平台 -->
  <profile>
    <id>macos</id>
    <activation>
      <os>
        <family>mac</family>
      </os>
    </activation>
    <dependencies>
      <dependency>
        <groupId>org.eclipse.swt</groupId>
        <artifactId>org.eclipse.swt.cocoa.macosx.x86_64</artifactId>
        <version>4.26</version>
        <scope>test</scope>
      </dependency>
    </dependencies>
  </profile>
  <!-- Linux平台 -->
  <profile>
    <id>linux</id>
    <activation>
      <os>
        <family>unix</family>
        <name>linux</name>
      </os>
    </activation>
    <dependencies>
      <dependency>
        <groupId>org.eclipse.swt</groupId>
        <artifactId>org.eclipse.swt.gtk.linux.x86_64</artifactId>
        <version>4.26</version>
        <scope>test</scope>
      </dependency>
    </dependencies>
  </profile>
</profiles>

Gradle示例 #

Gradle可以直接通过系统属性动态添加对应平台的依赖：

testImplementation {
    def os = org.gradle.nativeplatform.platform.internal.DefaultNativePlatform.currentOperatingSystem
    if (os.isWindows()) {
        implementation 'org.eclipse.swt:org.eclipse.swt.win32.win32.x86_64:4.26'
    } else if (os.isMacOsX()) {
        implementation 'org.eclipse.swt:org.eclipse.swt.cocoa.macosx.x86_64:4.26'
    } else if (os.isLinux()) {
        implementation 'org.eclipse.swt:org.eclipse.swt.gtk.linux.x86_64:4.26'
    }
}

2. 用JUnit5 Extension干预Classpath（代码层面） #

如果必须在测试代码层面处理，JUnit5的@ExtendWith可以配合自定义扩展，通过自定义类加载器或者干预测试类加载流程来过滤Classpath：

自定义Extension示例 #

这个思路是在测试实例创建前，替换默认的类加载器，过滤掉不匹配平台的SWT jar：

import org.junit.jupiter.api.extension.ExtensionContext;
import org.junit.jupiter.api.extension.TestInstancePostProcessor;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.ArrayList;
import java.util.List;

public class SwtClasspathFilterExtension implements TestInstancePostProcessor {

    @Override
    public void postProcessTestInstance(Object testInstance, ExtensionContext context) throws Exception {
        // 获取当前平台对应的SWT jar标识
        String platformSwtMarker = getPlatformSwtMarker();
        
        // 提取当前Classpath的所有URL
        ClassLoader currentClassLoader = Thread.currentThread().getContextClassLoader();
        URL[] originalUrls = ((URLClassLoader) currentClassLoader).getURLs();
        
        // 过滤出符合当前平台的依赖
        List<URL> filteredUrls = new ArrayList<>();
        for (URL url : originalUrls) {
            String urlStr = url.toString();
            // 保留非SWT依赖，或者匹配当前平台的SWT依赖
            if (!urlStr.contains("org.eclipse.swt") || urlStr.contains(platformSwtMarker)) {
                filteredUrls.add(url);
            }
        }
        
        // 创建过滤后的类加载器并设置为上下文类加载器
        URLClassLoader filteredClassLoader = new URLClassLoader(filteredUrls.toArray(new URL[0]), currentClassLoader.getParent());
        Thread.currentThread().setContextClassLoader(filteredClassLoader);
    }

    private String getPlatformSwtMarker() {
        String osName = System.getProperty("os.name").toLowerCase();
        if (osName.contains("win")) {
            return "win32.win32.x86_64";
        } else if (osName.contains("mac")) {
            return "cocoa.macosx.x86_64";
        } else if (osName.contains("linux")) {
            return "gtk.linux.x86_64";
        }
        throw new IllegalStateException("Unsupported operating system: " + osName);
    }
}

然后在测试类上启用这个扩展：

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;

@ExtendWith(SwtClasspathFilterExtension.class)
public class SwtGuiTest {

    @Test
    public void testSwtButtonRender() {
        // 测试逻辑：此时Classpath中仅包含当前平台的SWT库
    }
}

注意：如果测试类已经提前被加载，可能需要调整扩展的执行时机（比如实现BeforeAllCallback或LauncherSessionListener），不过上面的TestInstancePostProcessor在测试实例创建前执行，大多数场景下足够用。

3. JUnit4 vs JUnit5的差异说明 #

• JUnit4的自定义Runner是接管整个测试生命周期，而JUnit5的Extension是模块化的扩展点，不需要替换整个测试运行器，只针对特定环节（比如类加载、实例创建）做干预。
• JUnit5的扩展模型更灵活，支持多种扩展接口，你可以根据需求选择最合适的扩展点，而非必须实现完整的Runner逻辑。

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