Docker环境GraalVM原生镜像下MySQL JDBC驱动运行异常问题

问题背景 #

• 构建环境：基于ghcr.io/graalvm/graalvm-ce:latest基础镜像打包，构建流程为镜像内先安装native-image组件，再将业务Jar包通过native-image --no-fallback编译为原生可执行文件
• 依赖配置：Maven依赖包含mysql:mysql-connector-java:8.0.29、com.oracle.database.jdbc:ojdbc8:21.5.0.0，业务代码通过DriverManager获取AWS RDS MySQL连接执行基础SQL查询
• 异常特征：所有异常仅在GraalVM原生镜像运行时触发，相同代码包在amazoncorretto:18-alpine等常规JVM环境下运行完全正常，属于GraalVM + JDBC/MySQL + Docker组合场景下的通用类问题

已尝试修复与对应报错 #

初始运行报错 #

首次启动原生镜像直接抛出java.lang.ExceptionInInitializerError，根因是java.util.MissingResourceException：无法找到基础名称为com.mysql.cj.LocalizedErrorMessages、locale为en_US的资源束。

第一次修复后的新异常 #

修复操作：

• 新增resource-config.json，配置将com.mysql.cj.LocalizedErrorMessages.properties纳入原生镜像资源范围
• 在native-image.properties中添加构建参数，启用http/https协议支持，指定反射配置、资源配置文件的加载路径
  修复结果：资源缺失问题消失，但抛出新的java.lang.ClassCastException：com.mysql.cj.exceptions.CJException无法转换为com.mysql.cj.exceptions.WrongArgumentException。

第二次修复后的新异常 #

修复操作：在reflect-config.json中补充注册所有MySQL连接URL实现类、日志实现类、MySQL驱动类，以及Oracle JDBC相关扩展类的反射访问权限，开放所有声明字段、方法、构造器的访问权限。
修复结果：类转换异常的触发位置发生变化，抛出java.sql.SQLNonTransientConnectionException，错误提示无法连接目标MySQL服务器（端口被异常解析为3,306），根因是CJException无法转换为com.mysql.cj.exceptions.UnableToConnectException。

可行修复方案 #

• 不要手动维护native-image配置文件，直接使用GraalVM提供的追踪代理自动生成全量配置：在常规JVM环境下启动应用时添加-agentlib:native-image-agent=config-output-dir=./META-INF/native-image参数，跑完所有业务流程（包括建立数据库连接、执行SQL、覆盖所有可能的异常触发分支），工具会自动生成完整的反射、资源、动态代理、JNI配置，从根源避免手动漏配类、资源的问题。
• 针对MySQL Connector/J 8.0.x版本做专项适配：
  • 资源配置不要只添加en_US版本的错误信息束，需要将com/mysql/cj/路径下所有properties资源（包括多语言错误信息、TlsSettings.properties等）全量纳入原生镜像资源范围
  • 反射配置必须注册com.mysql.cj.exceptions包下的所有异常类，且开放所有异常类的构造器访问权限——MySQL驱动会动态实例化对应异常子类做抛出和类型转换，漏注册时会回退为实例化CJException基类，触发强转失败
  • 端口解析为3,306的问题本质是URL解析类的字段反射权限未完全开放，导致数字类型的端口值解析时出现字符错位，需确保com.mysql.cj.conf.url包下所有URL实现类的全部字段都被纳入反射注册范围
• 构建原生镜像时追加参数--initialize-at-run-time=com.mysql.cj.jdbc,com.mysql.cj.exceptions,com.mysql.cj.conf，将MySQL驱动核心类配置为运行时初始化，避免构建时静态初始化导致的变量状态异常。
• 如果当前业务不需要连接Oracle数据库，构建时可将ojdbc8依赖从类路径中裁剪，减少多余类对native-image静态分析的干扰。

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