Groovy与Kotlin在Maven项目中如何共存编译？

Question

在多语言JVM项目中，Groovy与Kotlin共存于Maven构建时，常出现编译顺序问题：Kotlin编译任务（kotlin-maven-plugin）默认在compile阶段执行，而Groovy编译（gmavenplus-plugin）若未正确绑定至同一生命周期阶段，可能导致相互引用的类无法解析。例如，Kotlin代码调用Groovy类时提示“unresolved reference”。如何配置插件执行顺序，确保Groovy源码先于或与Kotlin协同编译，是实现二者无缝共存的关键挑战。

Answer 1

多语言JVM项目中Groovy与Kotlin共存的编译顺序问题深度解析

1. 问题背景：Maven生命周期与多语言编译冲突

在现代JVM生态中，多语言混合编程已成为常态。Groovy因其动态特性广泛应用于DSL、脚本化逻辑及Spock测试框架；而Kotlin凭借其简洁语法和空安全机制，在Android开发与后端服务中迅速普及。当两者共存于同一Maven项目时，编译顺序成为关键瓶颈。

Maven默认的compile阶段仅处理Java源码。对于非Java语言，需依赖插件扩展生命周期行为。然而，不同插件对执行阶段的绑定策略不一致：

• kotlin-maven-plugin 默认绑定至 compile 阶段
• gmavenplus-plugin 若未显式配置，可能延迟到后续阶段（如generate-sources）

这导致Kotlin编译器在执行时无法感知Groovy类的存在，从而抛出“unresolved reference”错误。

2. 分析过程：Maven插件绑定机制剖析

理解Maven的构建生命周期是解决该问题的前提。Maven定义了三大标准生命周期：default、clean、site，其中default包含23个阶段，从validate到install。

阶段	描述	典型任务
process-sources	处理源代码（如过滤资源）	资源替换
generate-sources	生成额外源码目录	Annotation Processing
compile	编译主代码	javac, kotlinc
process-classes	处理编译后的类文件	字节码增强

关键点在于：若Groovy编译未在compile前完成，则其生成的.class文件不会被加入编译类路径，Kotlin编译器自然无法引用。

3. 解决方案一：显式控制插件执行顺序

通过在pom.xml中明确指定插件绑定阶段，可强制Groovy先于Kotlin编译：

<build>
  <plugins>
    <!-- Groovy 编译插件 -->
    <plugin>
      <groupId>org.codehaus.gmavenplus</groupId>
      <artifactId>gmavenplus-plugin</artifactId>
      <version>1.13.1</version>
      <executions>
        <execution>
          <id>compile-groovy</id>
          <phase>generate-sources</phase>
          <goals>
            <goal>compile</goal>
          </goals>
        </execution>
      </executions>
    </plugin>

    <!-- Kotlin 编译插件 -->
    <plugin>
      <groupId>org.jetbrains.kotlin</groupId>
      <artifactId>kotlin-maven-plugin</artifactId>
      <version>1.9.0</version>
      <executions>
        <execution>
          <id>compile-kotlin</id>
          <phase>compile</phase>
          <goals>
            <goal>compile</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

上述配置确保Groovy源码在generate-sources阶段完成编译，并将输出目录加入Maven主类路径，供后续Kotlin编译使用。

4. 解决方案二：使用混合编译模式（Joint Compilation）

更优策略是启用联合编译（joint compilation），即由单一编译器同时处理多种语言。Groovy支持通过AST转换机制识别Kotlin类，但反向支持有限。因此推荐采用以下结构：

1. 将相互引用的类拆分至独立模块（module-per-language）
2. 构建层级依赖关系：groovy-core → kotlin-service
3. 利用Maven多模块构建自动排序优势

示例项目结构：

my-project/
├── groovy-domain/       # Groovy实体与DSL
│   └── src/main/groovy/
├── kotlin-application/  # Kotlin业务逻辑
│   └── src/main/kotlin/
└── pom.xml (multi-module)

5. 进阶挑战：循环依赖与增量编译

当Groovy与Kotlin代码存在双向引用时，单纯调整编译顺序无法根本解决。此时需引入架构层面解耦：

graph TD A[Shared Interfaces] --> B(Groovy Implementation) A --> C(Kotlin Implementation) B --> D[Kotlin Business Logic] C --> D style A fill:#f9f,stroke:#333

设计原则：

• 提取公共接口至独立shared-contracts模块
• 各语言实现层仅依赖接口而非具体实现
• 避免跨语言直接继承或内部类访问

6. 工具链优化建议

为提升开发效率，建议结合以下工具：

工具	用途	配置提示
Build Helper Maven Plugin	添加Groovy源目录	<addSource> 绑定至 generate-sources
Kotlin Compiler Plugin	启用Java互操作性选项	-Xjvm-default=all-compatibility
Gradle (替代方案)	原生支持多语言联合编译	kotlin("jvm") + groovy() 插件协同
IDEA 编译器设置	同步Maven编译顺序	Settings → Build → Compiler → Allow parallel build

此外，开启Maven的调试日志（mvn compile -X）有助于追踪插件执行顺序与类路径构建过程。