如何在Java的main方法中启动JUnit Jupiter测试？

我之前也遇到过类似的需求——不想写正规的单元/集成测试，也不想Mock S3，就是想快速跑一段AWS SDK代码调试验证。用JUnit 5 Jupiter的Launcher确实是个绝佳方案，既能利用JUnit的测试框架能力，又能直接在main方法里触发执行，完全符合快速开发调试的场景。下面给你一步步拆解怎么实现：

本质上就是绕过常规JUnit测试的IDE/构建工具依赖，直接用JUnit 5提供的Launcher API，在自定义的main方法里手动加载、执行我们写的S3测试代码。这样既可以享受JUnit的注解、断言等便利，又能直接调用真实的S3服务，完美适配快速开发调试的需求。

1. 先搞定依赖 #

首先确保项目里引入了JUnit 5 Jupiter的核心依赖，以及AWS SDK for S3的依赖（这里以Maven为例）：

<dependencies>
    <!-- JUnit 5 Jupiter 核心依赖 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.9.2</version>
    </dependency>
    <!-- AWS SDK for S3 -->
    <dependency>
        <groupId>software.amazon.awssdk</groupId>
        <artifactId>s3</artifactId>
        <version>2.20.100</version>
    </dependency>
</dependencies>

2. 写你的S3测试代码 #

创建一个普通的JUnit 5测试类，把你要调试的S3操作写在带@Test注解的方法里——比如上传、下载对象：

import org.junit.jupiter.api.Test;
import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.PutObjectRequest;
import software.amazon.awssdk.services.s3.model.GetObjectRequest;
import java.nio.file.Paths;

public class S3QuickDebugTest {

    // 初始化S3客户端，用默认凭证链（本地配置、环境变量等）
    private final S3Client s3Client = S3Client.builder()
            .region(Region.US_EAST_1) // 根据你的实际区域调整
            .credentialsProvider(DefaultCredentialsProvider.create())
            .build();

    @Test
    void testPutAndFetchS3Object() {
        String testBucket = "your-personal-test-bucket"; // 替换成你的测试桶
        String objectKey = "debug-test-file.txt";
        String localUploadPath = "./local-test-content.txt";
        String localDownloadPath = "./downloaded-from-s3.txt";

        // 执行上传操作
        s3Client.putObject(PutObjectRequest.builder()
                        .bucket(testBucket)
                        .key(objectKey)
                        .build(),
                Paths.get(localUploadPath));

        // 执行下载操作
        s3Client.getObject(GetObjectRequest.builder()
                        .bucket(testBucket)
                        .key(objectKey)
                        .build(),
                Paths.get(localDownloadPath));

        System.out.println("✅ S3上传下载操作执行完成！");
    }

    // 可以加更多@Test方法，测试不同的S3操作，比如删除对象、列举桶内容等
    @Test
    void testListBucketContents() {
        s3Client.listObjectsV2(req -> req.bucket("your-personal-test-bucket"))
                .contents()
                .forEach(obj -> System.out.println("📦 桶内对象：" + obj.key()));
    }
}

3. 写main方法触发测试 #

创建一个带main方法的类，用JUnit 5的Launcher API来加载并执行上面的测试类：

import org.junit.platform.launcher.Launcher;
import org.junit.platform.launcher.LauncherDiscoveryRequest;
import org.junit.platform.launcher.core.LauncherDiscoveryRequestBuilder;
import org.junit.platform.launcher.core.LauncherFactory;
import org.junit.platform.launcher.listeners.SummaryGeneratingListener;
import org.junit.platform.launcher.listeners.TestExecutionSummary;

import static org.junit.platform.engine.discovery.DiscoverySelectors.selectClass;

public class S3DebugLauncher {

    public static void main(String[] args) {
        // 构建测试发现请求，指定要执行的测试类
        LauncherDiscoveryRequest discoveryRequest = LauncherDiscoveryRequestBuilder.request()
                .selectors(selectClass(S3QuickDebugTest.class))
                .build();

        // 创建JUnit Launcher实例
        Launcher launcher = LauncherFactory.create();

        // 添加监听器，收集测试执行结果
        SummaryGeneratingListener resultListener = new SummaryGeneratingListener();
        launcher.registerTestExecutionListeners(resultListener);

        // 执行测试
        launcher.execute(discoveryRequest);

        // 打印测试执行总结
        TestExecutionSummary summary = resultListener.getSummary();
        System.out.println("\n=== 测试执行结果 ===");
        summary.printTo(System.out);
    }
}

• 凭证配置：确保你的AWS凭证已经正确配置（比如~/.aws/credentials文件、环境变量，或者IDE的AWS配置），否则S3Client无法正常调用服务。
• 调试便利：直接在S3测试方法里加断点，运行main方法就能进入调试模式，一步步排查代码问题。
• 灵活扩展：如果要测试多个操作，只需要在测试类里新增@Test方法即可，Launcher会自动执行所有标记的测试。
• 批量执行：如果有多个测试类，可以把selectClass换成selectPackage，指定包名来批量扫描执行测试。

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