如何从Bazel运行Kotest测试？Gradle大型单仓迁移求助

一、基础配置步骤 #

1. WORKSPACE文件配置 #

在仓库根目录的WORKSPACE中引入Bazel Kotlin规则和Kotest依赖：

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

# 引入Bazel Kotlin规则
http_archive(
    name = "io_bazel_rules_kotlin",
    urls = ["https://github.com/bazelbuild/rules_kotlin/releases/download/v1.9.0/rules_kotlin-v1.9.0.tar.gz"],
    sha256 = "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
)

load("@io_bazel_rules_kotlin//kotlin:repositories.bzl", "kotlin_repositories")
kotlin_repositories()

load("@io_bazel_rules_kotlin//kotlin:core.bzl", "kt_register_toolchains")
kt_register_toolchains()

# 引入Kotest官方规则
http_archive(
    name = "kotest",
    urls = ["https://github.com/kotest/kotest/releases/download/v5.6.2/kotest-5.6.2.tar.gz"],
    sha256 = "b2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3",
)

load("@kotest//:repositories.bzl", "kotest_repositories")
kotest_repositories()

# 统一管理Maven依赖（对齐Gradle版本）
load("@bazel_tools//tools/build_defs/repo:maven.bzl", "maven_install")
maven_install(
    artifacts = [
        "io.kotest:kotest-runner-jvm-junit5:5.6.2",
        "io.kotest:kotest-assertions-core-jvm:5.6.2",
        # 其他项目依赖，如MockK、Spring扩展等
    ],
    repositories = ["https://repo1.maven.org/maven2/"],
)

2. BUILD文件配置 #

针对每个测试模块，有两种常用配置方式：

方式一：Kotest专用规则（推荐）

使用Kotest官方提供的简化规则，无需手动配置运行器：

load("@kotest//:kotest.bzl", "kotest_jvm_test")
load("@io_bazel_rules_kotlin//kotlin:kotlin.bzl", "kt_jvm_library")

# 主代码库
kt_jvm_library(
    name = "main_code",
    srcs = glob(["src/main/kotlin/**/*.kt"]),
    deps = [/* 主代码依赖 */],
)

# Kotest测试目标
kotest_jvm_test(
    name = "unit_tests",
    srcs = glob(["src/test/kotlin/**/*.kt"]),
    deps = [
        ":main_code",
        "@maven//:io_kotest_kotest_assertions_core_jvm",
        # 测试依赖，如@maven//:io_mockk_mockk
    ],
    tags = ["unit_test"], # 标记测试类型，方便分类执行
)

方式二：手动配置Kotlin测试规则

需要指定Kotest的JUnit5运行器，适合自定义需求：

load("@io_bazel_rules_kotlin//kotlin:kotlin.bzl", "kt_jvm_test", "kt_jvm_library")

kt_jvm_library(
    name = "main_code",
    srcs = glob(["src/main/kotlin/**/*.kt"]),
)

kt_jvm_test(
    name = "unit_tests",
    srcs = glob(["src/test/kotlin/**/*.kt"]),
    deps = [
        ":main_code",
        "@maven//:io_kotest_kotest_runner_jvm_junit5",
        "@maven//:io_kotest_kotest_assertions_core_jvm",
    ],
    jvm_flags = ["-Dkotest.framework.classpath.scanning.config.disable=true"], # 禁用类路径扫描提升性能
)

二、大型单体仓库迁移实践要点 #

• 批量生成BUILD文件：用脚本（Python/Shell）扫描仓库目录，自动为每个模块生成测试目标，减少手动工作量。
• 依赖版本对齐：导出Gradle依赖锁定文件，转换为Bazel的maven_install配置，确保依赖版本完全一致，避免兼容性问题。
• 测试分类与增量执行：用tags标记单元/集成测试，通过bazel test --tags=unit_test //...批量执行指定类型测试；利用Bazel增量构建特性，仅运行变更代码对应的测试。
• 扩展支持：使用Kotest扩展（如Spring、Mockito）时，直接在deps中添加对应依赖，例如Spring扩展：@maven//:io_kotest_kotest_extensions_spring。

三、测试代码示例 #

现有Kotest测试类无需修改即可在Bazel中运行：

import io.kotest.core.spec.style.StringSpec
import io.kotest.matchers.shouldBe

class UserServiceTest : StringSpec({
    "should return correct user name" {
        val service = UserService()
        service.getUserName(1) shouldBe "Alice"
    }

    "should handle non-existent user" {
        val service = UserService()
        service.getUserName(999) shouldBe "Unknown"
    }
})

四、运行测试命令 #

• 单个测试目标：bazel test //path/to/module:unit_tests
• 所有测试：bazel test //...
• 指定标签测试：bazel test --tags=unit_test //...

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