Ballerina基于GraalVM构建原生可执行文件的JDBC错误问题

H2驱动场景：原生可执行文件运行报错 #

运行jar文件正常，但原生可执行文件启动时抛出以下错误：

error: Error in SQL connector configuration: Failed to initialize pool: null Caused by :null

依赖配置如下：

[[platform.java11.dependency]]
artifactId = "h2"
version = "2.0.206"
groupId = "com.h2database"

解决步骤： #

• 添加GraalVM反射配置
  H2驱动的部分类需要在原生镜像构建时被显式注册，创建reflect-config.json文件，包含以下内容：

  [
    {
      "name": "org.h2.jdbc.JdbcConnection",
      "allDeclaredConstructors": true,
      "allPublicConstructors": true,
      "allDeclaredMethods": true,
      "allPublicMethods": true
    },
    {
      "name": "org.h2.pool.PooledConnection",
      "allDeclaredConstructors": true,
      "allPublicConstructors": true,
      "allDeclaredMethods": true,
      "allPublicMethods": true
    }
  ]
  

  构建时通过--reflect-config参数指定该文件。

• 显式初始化H2驱动
  在Ballerina代码的启动阶段主动加载驱动类，避免GraalVM静态分析遗漏：

  import ballerina/jballerina.java;
  
  public function init() returns error? {
      _ = java:loadClass("org.h2.Driver");
  }
  

• 检查JDBC URL配置
  确保原生运行时的JDBC URL使用正确模式，比如H2嵌入式模式需指定绝对文件路径，避免相对路径导致的文件访问问题。

MSSQL连接器场景：构建分析阶段失败 #

在构建的[2/7] Performing analysis...阶段抛出致命错误，核心报错片段：

Fatal error: com.oracle.graal.pointsto.util.AnalysisError$ParsingError: Error encountered while parsing java.util.Calendar$Builder.build() 
...
Caused by: com.oracle.svm.hosted.substitute.DeletedElementException: Unsupported type java.util.JapaneseImperialCalendar is reachable

解决步骤： #

• 添加延迟检查参数
  构建时添加--report-unsupported-elements-at-runtime参数，将未支持元素的检查延迟到运行时，绕过构建阶段失败：

  bal build --graalvm-native --graalvm-options="--report-unsupported-elements-at-runtime"
  

• 排除不必要的认证模块
  报错路径显示与MSI认证相关，若你的场景不需要该认证方式，可通过--exclude-classes参数排除相关类：

  bal build --graalvm-native --graalvm-options="--exclude-classes=com.microsoft.sqlserver.jdbc.SQLServerSecurityUtility"
  

• 添加初始化配置
  创建resource-config.json文件，指定MSSQL驱动类在构建时初始化：

  [
    {
      "name": "com.microsoft.sqlserver.jdbc.SQLServerDriver",
      "initializeAtBuildTime": true
    }
  ]
  

  构建时通过--resource-config参数指定该文件。

• 升级MSSQL驱动版本
  尝试使用更高版本的MSSQL JDBC驱动（如12.4.0.jre11+），新版本通常对GraalVM兼容性更好。

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