如何为Maven多模块Spring Boot 3应用编译GraalVM Native Image？

核心问题分析 #

父模块属于pom类型（无业务代码），直接在父模块执行mvn -Pnative native:compile会因类路径为空报错；单独在heroes-webapp执行时找不到类，通常是依赖的heroes-backend模块未被正确纳入Native Image构建类路径，或是Native插件配置未适配多模块场景。

分步解决方案 #

1. 调整父模块与子模块的Native插件配置 #

• 父模块pom.xml仅需引入Native插件的管理配置，不要直接绑定执行目标：

<build>
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.graalvm.buildtools</groupId>
                <artifactId>native-maven-plugin</artifactId>
                <version>0.9.18</version>
                <extensions>true</extensions>
            </plugin>
        </plugins>
    </pluginManagement>
</build>

• heroes-webapp模块的pom.xml中，启用Native插件并确保正确声明heroes-backend依赖：

<dependencies>
    <dependency>
        <groupId>对应groupId</groupId>
        <artifactId>heroes-backend</artifactId>
        <version>项目版本号</version>
    </dependency>
    <!-- 其他Spring Boot基础依赖 -->
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.graalvm.buildtools</groupId>
            <artifactId>native-maven-plugin</artifactId>
            <executions>
                <execution>
                    <id>native-compile</id>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                    <phase>package</phase>
                </execution>
            </executions>
        </plugin>
        <!-- 保留Spring Boot Maven插件配置 -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

2. 执行正确的构建流程 #

• 先在父模块执行完整构建，确保所有子模块安装到本地仓库：

mvn clean install -DskipTests

• 进入heroes-webapp模块，执行Native Image构建：

cd heroes-webapp
mvn -Pnative native:compile

3. 类找不到问题的额外排查 #

• 检查heroes-backend模块的打包类型：必须是jar类型，确保mvn install后生成的jar包含编译后的类文件（不能是pom类型）。
• 若自动识别类路径失效，可在heroes-webapp的Native插件配置中显式指定依赖模块的类路径：

<plugin>
    <groupId>org.graalvm.buildtools</groupId>
    <artifactId>native-maven-plugin</artifactId>
    <configuration>
        <classpath>
            <path>../heroes-backend/target/classes</path>
            <path>${project.build.outputDirectory}</path>
        </classpath>
    </configuration>
</plugin>

4. 验证构建结果 #

构建完成后，heroes-webapp/target目录下会生成可执行的Native Image文件，直接运行即可：

./target/heroes-webapp

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