Maven多模块项目如何引入Gradle子项目以实现逐步迁移？

当然有官方支持的方案！Gradle本身就提供了和Maven互操作的能力，完全能满足你「先迁移少数子项目到Gradle，同时让它们继续作为父Maven项目的一部分参与整体构建」的需求。下面我会把具体实现方式、好用的插件和实践经验一一拆解：

一、官方支持的核心实现路径 #

1. 以Maven为主，触发Gradle子项目构建 #

如果当前还是以Maven父项目作为构建入口，你可以在父POM中配置插件，让Maven在构建的特定阶段自动调用Gradle命令来构建目标子项目，并且把Gradle生成的产物同步到Maven预期的目录，这样整个Maven构建流程就能无缝包含Gradle子项目的产物。

比如用exec-maven-plugin的示例配置：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>build-gradle-submodule</id>
            <phase>generate-resources</phase> <!-- 在Maven资源生成阶段触发Gradle构建 -->
            <goals>
                <goal>exec</goal>
            </goals>
            <configuration>
                <executable>./gradlew</executable> <!-- 用Gradle wrapper避免环境依赖 -->
                <workingDirectory>${project.basedir}/path/to/your-gradle-submodule</workingDirectory>
                <arguments>
                    <argument>build</argument>
                    <argument>-x</argument>
                    <argument>test</argument> <!-- 可选：临时跳过测试加快构建，正式构建记得去掉 -->
                </arguments>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 以Gradle为主，反向集成Maven项目 #

如果后续计划逐步过渡到Gradle主导整个构建，Gradle官方更推荐这种方式：用Gradle的maven插件直接导入整个Maven多模块项目，然后你只需要给要迁移的子项目添加build.gradle脚本。Gradle会自动识别Maven的依赖关系，未迁移的子项目依然用Maven构建，已迁移的则优先使用Gradle脚本。

这种方式的好处是可以统一用Gradle命令构建所有项目，逐步替换子项目，过渡更平滑。

二、推荐的实用插件 #

1. Gradle maven-publish插件 #

这个是Gradle官方插件，用来把Gradle子项目的Jar、POM等产物发布到本地Maven仓库（~/.m2/repository）。这样Maven父项目可以像依赖普通Maven模块一样依赖这个Gradle子项目，不需要直接调用Gradle命令，集成更松散。

示例Gradle配置：

plugins {
    id 'maven-publish'
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
        }
    }
    repositories {
        mavenLocal()
    }
}

使用时先执行./gradlew publishToMavenLocal把产物推到本地仓库，然后在Maven父POM中添加对应的依赖即可。

2. Maven gradle-maven-plugin（第三方常用插件） #

这个插件专门为Maven集成Gradle项目设计，比exec-maven-plugin更简洁，能自动处理Gradle任务调用和产物同步，减少手动配置的麻烦。

示例Maven配置：

<plugin>
    <groupId>com.github.gradle-maven-plugin</groupId>
    <artifactId>gradle-maven-plugin</artifactId>
    <version>1.0.2</version>
    <executions>
        <execution>
            <id>gradle-build</id>
            <phase>process-resources</phase>
            <goals>
                <goal>gradle</goal>
            </goals>
            <configuration>
                <tasks>build</tasks>
                <projectDir>${project.basedir}/path/to/your-gradle-submodule</projectDir>
            </configuration>
        </execution>
    </executions>
</plugin>

三、最佳实践建议 #

• 对齐产物目录与命名：让Gradle子项目的输出目录和Maven保持一致（比如把Gradle的build/libs产物复制到Maven的target目录），同时确保Gradle生成的Jar包名称和Maven模块名一致，避免Maven找不到产物。示例Gradle配置：

jar {
    destinationDir file("${project.parent.projectDir}/target") // 同步到父Maven项目的target目录
    archiveBaseName = 'your-module-name' // 和Maven模块名保持一致
}

• 统一依赖版本：初期可以让Gradle子项目继承Maven父POM的依赖管理，用Gradle的mavenBom导入Maven父POM，确保整个项目的依赖版本统一：

dependencies {
    implementation platform('com.your.group:parent-pom:1.0.0') // 替换成你的父POM坐标
}

• 小步迁移，逐个验证：每次只迁移一个子项目，迁移完成后运行全量构建（Maven+Gradle）验证依赖、测试是否正常，避免一次性迁移带来的大量问题。
• 提取公共Gradle配置：如果要迁移多个子项目，把公共的配置（比如插件、依赖版本）提取到buildSrc或者根目录的settings.gradle中，保持Gradle脚本的一致性，减少重复代码。
• 避免循环依赖：梳理清楚Maven子项目和Gradle子项目之间的依赖关系，绝对不要出现循环依赖，否则会直接导致构建失败。

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