多模块Spring Boot项目构建GraalVM Native Image遇入口类问题求助

核心问题原因 #

多模块项目中，主类所在的子模块与父模块是分离的，直接在父pom中指定mainClass会导致GraalVM找不到目标类——因为父模块的classpath并不包含子模块的编译产物。

分步解决方案 #

1. 在主类所在的子模块中配置插件 #

找到包含org.example.api.Application的子模块（比如命名为api的模块），在该子模块的pom.xml中同时配置Spring Boot插件和GraalVM插件的主类参数：

<build>
    <plugins>
        <!-- Spring Boot插件配置主类 -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>org.example.api.Application</mainClass>
            </configuration>
        </plugin>

        <!-- GraalVM Native插件配置主类 -->
        <plugin>
            <groupId>org.graalvm.buildtools</groupId>
            <artifactId>native-maven-plugin</artifactId>
            <version>0.9.28</version>
            <executions>
                <execution>
                    <id>build-native</id>
                    <goals>
                        <goal>build</goal>
                    </goals>
                    <phase>package</phase>
                </execution>
            </executions>
            <configuration>
                <mainClass>org.example.api.Application</mainClass>
                <!-- 可添加其他Native Image配置，如初始化参数、资源路径等 -->
            </configuration>
        </plugin>
    </plugins>
</build>

2. 正确执行构建命令 #

不要在父模块根目录执行构建，切换到包含主类的子模块目录（比如./api），运行：

mvn clean package -Pnative

如果需要同时构建依赖的其他子模块，可以在父目录执行：

mvn clean package -pl api -am -Pnative

（-pl指定要构建的子模块，-am表示自动构建该模块依赖的所有其他模块）

3. 直接用native-image命令构建的方式（可选） #

如果不通过Maven插件，直接用GraalVM的native-image命令，需要先确保所有依赖模块已编译安装，再指定模块路径和主类：

# 先编译所有模块到本地仓库
mvn clean install
# 进入主模块target目录，执行native-image命令
cd api/target
native-image --module-path classes:dependency -m org.example.api/org.example.api.Application

4. 验证主类路径正确性 #

• 检查org.example.api.Application类的包名、类名是否完全匹配（注意大小写）。
• 确认子模块编译后，target/classes目录下存在org/example/api/Application.class文件。

常见误区规避 #

• 不要在父pom中直接指定mainClass：父模块本身不包含主类的编译产物，GraalVM无法在父模块的classpath中找到目标类。
• 确保依赖模块已正确编译：如果主模块依赖其他子模块，必须先完成依赖模块的编译安装，否则会出现类找不到的问题。

内容的提问来源于stack exchange，提问作者Amir Hossein Ohadi