如何配置OpenAPI Generator生成JUnit 5风格的Java客户端测试？

要让OpenAPI Generator Maven插件生成JUnit 5风格的测试用例，只需在插件配置中指定testFramework参数为JUNIT5即可，具体操作如下：

核心配置修改 #

在openapi-generator-maven-plugin的<configuration>节点内，添加<testFramework>JUNIT5</testFramework>配置项，这会覆盖默认的JUnit 4设置。

完整插件配置示例 #

<build>
    <plugins>
        <plugin>
            <groupId>org.openapitools</groupId>
            <artifactId>openapi-generator-maven-plugin</artifactId>
            <version>6.0.0</version> <!-- 建议使用6.0.0及以上版本，确保支持JUnit5 -->
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                    <configuration>
                        <inputSpec>${project.basedir}/src/main/resources/openapi.yaml</inputSpec>
                        <generatorName>java</generatorName>
                        <library>resttemplate</library> <!-- 根据项目需求选择合适的客户端库 -->
                        <testFramework>JUNIT5</testFramework> <!-- 关键配置：指定生成JUnit5测试用例 -->
                        <!-- 其他自定义配置 -->
                        <packageName>com.example.api.client</packageName>
                        <output>${project.build.directory}/generated-sources/openapi</output>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

注意事项 #

• 插件版本要求：必须使用6.0.0及以上版本的openapi-generator-maven-plugin，更早版本未支持JUnit5作为测试框架选项。
• JUnit5依赖引入：项目中需要添加JUnit5的核心依赖，确保测试可以正常运行：

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

配置完成后，执行mvn clean generate-sources重新生成代码，得到的测试用例就会使用JUnit5的注解（如org.junit.jupiter.api.Test），适配项目的JUnit5环境。

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