如何配置Gradle仅编译并运行带openApi标签的单个测试？

方案1：创建独立的测试源集（推荐） #

这种方式能彻底隔离生成OpenAPI的测试与其他测试，避免编译依赖冲突：

1. 定义专门的源集，仅包含生成OpenAPI所需的测试类：

sourceSets {
    openApiTest {
        java {
            srcDir 'src/test/java'
            // 替换为你的OpenAPI生成测试类路径，比如**/OpenApiSpecGenerator.java
            include '**/OpenApiSpecGenerator.java'
        }
        resources.srcDir 'src/test/resources'
        compileClasspath += sourceSets.main.output
        runtimeClasspath += sourceSets.main.output
    }
}

2. 配置generateOpenApiYml任务，使用上述源集并过滤标签：

task generateOpenApiYml(type: Test) {
    description = '生成open-api.yml规格文件（仅运行带openApi标签的测试）'
    testClassesDirs = sourceSets.openApiTest.output.classesDirs
    classpath = sourceSets.openApiTest.runtimeClasspath
    
    // 仅执行标记为openApi的测试方法
    useJUnitPlatform {
        includeTags 'openApi'
    }
    
    // 指定生成文件的输出路径，确保后续客户端生成任务能找到
    outputs.file("$buildDir/generated/openapi/open-api.yml")
}

3. 关联客户端生成与测试任务的依赖：

// 假设生成Java客户端的任务为generateOpenApiClient，根据实际插件调整
task generateOpenApiClient(type: JavaExec) {
    dependsOn generateOpenApiYml
    // 配置客户端生成的输入文件、输出目录等参数
    args = [
        '-i', file("$buildDir/generated/openapi/open-api.yml").absolutePath,
        '-g', 'java',
        '-o', "$buildDir/generated/openapi-client"
    ]
    // 其他配置（如指定OpenAPI Generator jar路径等）
}

// 让普通测试任务依赖客户端生成任务，确保生成完成后再执行测试
test {
    dependsOn generateOpenApiClient
    // 将生成的客户端类加入测试类路径
    classpath += files("$buildDir/generated/openapi-client/build/classes/java/main")
}

方案2：在现有任务中过滤编译范围 #

如果不想新增源集，可以直接调整generateOpenApiYml任务的编译与测试范围：

task generateOpenApiYml(type: Test) {
    description = '生成open-api.yml规格文件（仅运行带openApi标签的测试）'
    
    // 仅编译指定的测试类，避免编译依赖生成客户端的其他测试
    javaCompile {
        include '**/OpenApiSpecGenerator.java'
    }
    
    // 仅加载指定测试类的字节码
    testClassesDirs = fileTree(dir: sourceSets.test.output.classesDirs, include: '**/OpenApiSpecGenerator.class')
    
    // 过滤测试标签
    useJUnitPlatform {
        includeTags 'openApi'
    }
    
    outputs.file("$buildDir/generated/openapi/open-api.yml")
}

// 后续客户端生成与测试依赖配置同方案1

最后补充 #

将生成的Java客户端目录加入.gitignore：

# .gitignore
build/generated/openapi-client/

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