使用Buildpacks构建Spring Native应用遭遇UnresolvedElementException错误

问题复现 #

按官方流程使用Buildpacks构建Spring Native应用，已切换Java 11/17、本地安装GraalVM 17（22.2.0/22.3.0-dev），运行mvn spring-boot:build-image时触发com.oracle.graal.pointsto.constraints.UnresolvedElementException，核心报错信息：

Discovered unresolved method during parsing: org.springframework.beans.BeanUtils$KotlinDelegate.instantiateClass(java.lang.reflect.Constructor, java.lang.Object[])

但使用Native Build Tools构建生成的.exe可在Windows正常运行。

解决方案 #

1. 对齐Buildpacks与本地GraalVM版本 #

Buildpacks默认使用容器内的GraalVM环境，版本差异可能导致兼容性问题。在pom.xml中显式指定Buildpacks使用的GraalVM版本：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <image>
            <env>
                <!-- 替换为你本地使用的GraalVM版本 -->
                <BP_NATIVE_IMAGE_GRAALVM_VERSION>22.2.0</BP_NATIVE_IMAGE_GRAALVM_VERSION>
            </env>
        </image>
    </configuration>
</plugin>

2. 添加KotlinDelegate反射配置 #

若项目间接依赖Kotlin，需手动添加反射配置让GraalVM识别该方法。在src/main/resources/META-INF/native-image/reflect-config.json中写入：

[
  {
    "name": "org.springframework.beans.BeanUtils$KotlinDelegate",
    "methods": [
      {
        "name": "instantiateClass",
        "parameterTypes": ["java.lang.reflect.Constructor", "java.lang.Object[]"]
      }
    ]
  }
]

3. 确保Spring Boot与Spring Native版本兼容 #

检查版本组合是否符合官方推荐：

• Spring Boot 2.7.x 搭配 Spring Native 0.12.x
• Spring Boot 3.x 搭配 Spring Native 0.13.x+

较旧版本可能存在此类兼容性Bug，升级到对应稳定版即可解决。

4. 排除未使用的Kotlin依赖（可选） #

如果项目本身不使用Kotlin，可从Spring Boot Starter中排除Kotlin依赖，避免触发KotlinDelegate加载：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-stdlib</artifactId>
        </exclusion>
    </exclusions>
</dependency>

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