Spring Boot 3 GraalVM Native Image编译后Oracle JDBC驱动初始化失败求助

问题根源 #

GraalVM Native Image编译时会做静态代码分析，Oracle JDBC 19.3版本中oracle.jdbc.logging.annotations.Feature枚举的values()方法被动态调用，但Native Image未生成该方法的运行时元数据，导致初始化报错。

解决思路 #

1. 升级Oracle JDBC驱动版本 #

Oracle从21.10版本开始正式支持GraalVM Native Image，自带完善的Native配置文件，能自动处理反射、资源加载等需求。替换本地驱动为Maven中央仓库的兼容版本：
修改build.gradle的依赖：

dependencies {
    // 替换本地ojdbc8为官方支持Native的版本
    implementation 'com.oracle.database.jdbc:ojdbc8:21.13.0.0'
    // 其他依赖不变
    implementation 'org.springframework.boot:spring-boot-starter'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
}

2. 手动添加GraalVM反射配置 #

如果无法升级驱动，需手动创建反射配置文件告知Native Image保留枚举的关键方法：
在src/main/resources/META-INF/native-image目录下创建reflect-config.json，内容如下：

[
  {
    "name": "oracle.jdbc.logging.annotations.Feature",
    "methods": [
      {"name": "values", "parameterTypes": []},
      {"name": "valueOf", "parameterTypes": ["java.lang.String"]}
    ]
  }
]

3. 禁用Oracle JDBC诊断MBean #

通过关闭Diagnosability MBean注册来避免触发报错，可在Native Image构建时添加JVM参数：
修改build.gradle的graalvmNative配置：

graalvmNative {
    binaries {
        main {
            buildArgs.add("-Doracle.jdbc.diagnosability=false")
        }
    }
}

4. 升级GraalVM Build Tools插件 #

当前使用的0.9.27版本较旧，升级到最新稳定版可提升Spring Boot 3.x的Native兼容性：

plugins {
    // 替换为最新版本
    id 'org.graalvm.buildtools.native' version '0.10.2'
    // 其他插件不变
    id 'java'
    id 'org.springframework.boot' version '3.1.4'
    id 'io.spring.dependency-management' version '1.1.3'
}

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