GraalVM原生镜像构建报错：运行时应初始化的类在镜像构建阶段被意外初始化

看起来你遇到的是GraalVM原生镜像构建里典型的类初始化时机不匹配问题，尤其是Spring Boot结合Tomcat作为内嵌容器时偶尔会出现这类情况。虽然你两台机器配置看似完全一致，但大概率是本地环境的细微差异或者构建缓存导致的，咱们一步步来排查解决：

第一步：先清理构建缓存，排除缓存污染 #

很多时候这类奇怪的报错都是旧缓存搞的鬼，先彻底清一遍：

1. 运行Gradle清理命令：

./gradlew clean

2. 删除项目根目录下的.gradle文件夹（这个是本地Gradle缓存，删除后会重新生成）
3. 同时清理IntelliJ的缓存：点击File -> Invalidate Caches...，选择Invalidate and Restart，让IDE彻底刷新配置

第二步：确认环境没有其他JDK干扰 #

即使你设置了JAVA_HOME，有时候系统PATH里的其他JDK会优先被调用，导致GraalVM的工具链识别异常：

1. 打开命令提示符（不要用IDE的终端，直接开系统CMD），运行以下命令确认版本：

java -version
native-image --version

确保两个命令输出的都是你安装的GraalVM 21.0.6+8.1版本，如果有其他JDK的输出，调整PATH环境变量，把GraalVM的bin目录放到最前面。

第三步：手动指定类的初始化时机 #

如果上面的操作还是没解决问题，咱们直接强制让这两个Tomcat类在运行时再初始化，绕过构建阶段的初始化：

方式一：通过native-image配置文件

1. 在项目里创建src/main/resources/META-INF/native-image目录（如果不存在的话）
2. 新建native-image.properties文件，添加以下内容：

Args = --initialize-at-run-time=org.apache.catalina.connector.RequestFacade,org.apache.catalina.connector.ResponseFacade

方式二：通过Gradle任务配置

打开项目的build.gradle文件，找到nativeCompile任务，添加初始化参数：

nativeCompile {
    args.add('--initialize-at-run-time=org.apache.catalina.connector.RequestFacade,org.apache.catalina.connector.ResponseFacade')
}

第四步：检查Spring Boot AOT编译是否正常 #

Spring Boot的AOT编译会自动生成GraalVM需要的配置文件，如果AOT编译没正确执行，也会导致这类问题：
运行以下命令先手动执行AOT编译，再构建原生镜像：

./gradlew bootAotCompile nativeCompile

额外排查点（针对两台机器的差异） #

既然另一台机器没问题，你可以对比两台机器的这些细节：

• Gradle版本：确认两台机器用的Gradle版本完全一致（可以在settings.gradle里固定版本，比如gradleVersion = '8.10'）
• Windows系统补丁：是否其中一台有未安装的系统更新？某些Windows补丁可能影响GraalVM的编译流程
• GraalVM安装权限：确认安装GraalVM时用的是管理员权限，避免目录权限不足导致的文件损坏

按照这个流程试下来，应该能解决这个问题。如果还是不行，可以尝试重新下载安装GraalVM，确保安装包没有损坏。

备注：内容来源于stack exchange，提问作者Quin