使用GraalVM构建Spring Boot原生镜像后运行报错：找不到JarLauncher类

Spring Boot可执行Jar的启动逻辑依赖org.springframework.boot.loader.JarLauncher——它是真正的入口类，负责加载BOOT-INF/classes下的业务主类（即你的com.example.MyApp）和BOOT-INF/lib中的依赖。

你直接用native-image -cp "myJarFile.jar" com.example.MyApp构建时，原生镜像仅打包了com.example.MyApp相关的类，没有包含JarLauncher及Spring Boot的类加载框架。运行时，Spring Boot的初始化逻辑会尝试调用JarLauncher，但镜像中不存在该类，因此抛出ClassNotFoundException。

而将原Jar放在exe同目录时，exe会从外部Jar中读取JarLauncher类，因此能正常运行；直接用java -cp "myJarFile.jar" com.example.MyApp能跑，是因为JVM的类加载器可以从Jar的BOOT-INF目录中自动加载所有依赖类和启动逻辑，不需要显式指定JarLauncher。

推荐使用Spring Boot官方提供的原生镜像支持，它会自动处理启动类、依赖打包和GraalVM配置，无需手动编写复杂的native-image命令。

方法1：使用Spring Boot Maven插件生成原生镜像（推荐） #

适用于Spring Boot 3.x+（需配合GraalVM 22.3+）：

1. 确保本地已安装GraalVM，并配置好JAVA_HOME和PATH环境变量。
2. 在项目的pom.xml中添加Spring Boot Maven插件的原生镜像配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>${spring-boot.version}</version>
            <configuration>
                <nativeImage>
                    <!-- 可选：添加额外的native-image构建参数 -->
                    <buildArgs>--no-fallback</buildArgs>
                </nativeImage>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 执行以下命令生成原生镜像：

mvn spring-boot:native-image

生成的exe文件会位于target/目录下，可直接独立运行，无需依赖原Jar包。

方法2：手动调整native-image命令（不推荐，复杂度高） #

如果必须手动使用native-image命令，需要将JarLauncher作为主类，并确保所有Spring Boot加载逻辑和依赖都被打包：

native-image -cp "myJarFile.jar" org.springframework.boot.loader.JarLauncher

但这种方式需要额外处理GraalVM的反射、资源加载等配置（Spring Boot的动态特性需要提前告知GraalVM），通常需要编写reflect-config.json、resource-config.json等配置文件，不如官方插件自动化处理可靠。

内容的提问来源于stack exchange，提问作者Thinker-101