Gradle切换至Kotlin/Ktor后替代原ScalaCompile逻辑及实现构建启动后端跑E2E测试的方案

原Scala自定义编译插件的等价适配 #

• 无需引入第三方Gradle插件，直接基于Gradle 6.0.1稳定的任务API实现原Scala插件的全部能力，核心是对org.jetbrains.kotlin.gradle.tasks.KotlinCompile类型的任务做统一配置，替代原ScalaCompile的适配逻辑。
• 具体配置可直接写入后端模块的build.gradle文件，替换原ScalaCompilerPlugin的apply逻辑：

// 声明用于存放Kotlin编译器插件的依赖配置，和原scalaCompilerPlugin配置作用完全对齐
configurations {
    kotlinCompilerPlugin
}

// 全局适配所有Kotlin编译任务
afterEvaluate {
    // 匹配所有类型为KotlinCompile的任务
    tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
        // 对齐原Scala逻辑，统一设置编译编码为UTF-8
        kotlinOptions.encoding = 'UTF-8'
        // 向编译参数追加编译器插件路径，和原-Xplugin参数传参逻辑完全一致
        kotlinOptions.freeCompilerArgs += [
            "-Xplugin=${configurations.kotlinCompilerPlugin.asPath}"
        ]
    }
}

• 说明：Gradle 6.0.1适配的稳定版Kotlin Gradle插件（1.3.6x系列）中，kotlinOptions.freeCompilerArgs是公开稳定API，完全支持传递编译器插件路径参数，不存在无对应API的适配障碍。

E2E测试流程的服务启动对接 #

• 原项目使用的com.github.psxpaul.execfork插件不绑定Scala技术栈，迁移后可直接保留使用，无需重写服务启停逻辑。
• 具体流程调整：
  1. 保留原有插件引入：在后端模块的plugins配置中继续保留id 'com.github.psxpaul.execfork' version '0.1.12'，该插件可实现后台长驻进程启动、启动就绪信号匹配、测试完成后自动关停进程的全流程能力。
  2. 替换原Scala应用启动任务的配置，指向Ktor应用的入口：

// 配置后台启动Ktor服务的任务
task startBackend(type: com.github.psxpaul.task.ExecFork) {
    // 替换为Ktor应用主类的全路径
    main = 'com.yourorg.ktor.ApplicationKt'
    // 匹配服务启动完成的日志，作为服务就绪的判断信号
    waitFor = 'Application started'
    // 保持原服务的运行参数、JVM配置不变
    args = ['-port=8080']
    jvmArgs = ['-Xmx1g']
}

3. 建立任务依赖关系，保证执行顺序正确：

// 配置E2E测试任务
task e2eTest(type: Test) {
    // 依赖后端服务启动任务，服务就绪后才开始执行测试
    dependsOn startBackend
    // 测试执行完成后，自动触发后端服务关停逻辑
    finalizedBy startBackend.stop
    // 保持原E2E测试的类路径、测试资源配置不变
    testClassesDirs = sourceSets.e2e.output.classesDirs
    classpath = sourceSets.e2e.runtimeClasspath
}

架构优化方向 #

• 将分散在各模块的Kotlin编译适配逻辑，提取到项目的buildSrc目录做统一封装，避免重复配置，后续升级Kotlin版本时只需修改一处适配逻辑即可覆盖所有模块。
• 解耦编译流程和服务启动流程：不要将服务启动的逻辑绑定到编译任务的生命周期中，严格按照Gradle任务依赖规范建立调用链，避免编译阶段被无关的服务启动逻辑阻塞。
• 优化E2E测试的环境一致性：将固定的服务端口改为动态分配的可用端口，避免本地开发环境的端口占用冲突，execfork插件本身支持匹配动态端口的启动日志信号。
• 简化配置冗余：原项目中通过独立插件类实现编译逻辑封装的方式，可替换为buildSrc中的约定插件，不需要在每个业务模块重复编写afterEvaluate的适配代码，降低配置维护成本。

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