如何让GraalVM Native Image正确加载指定Java属性？

问题背景 #

将基于JDBC Kerberos认证的Java程序通过GraalVM编译为Native Image后，无论构建时指定-Djava.security.krb5.conf、运行时传递参数还是设置KRB5_CONFIG环境变量，程序始终读取默认的/etc/krb5/krb5.conf，无法加载自定义配置文件。

可行解决方案 #

1. 运行Native Image时正确传递JVM属性

Native Image运行时的JVM属性需要放在二进制文件名之后，而非之前。执行命令格式如下：

./singlequeryexecutor -Djava.security.krb5.conf=/opt/kevin/krb5/krb5.conf

注：若将-D参数放在二进制名称前，会被识别为native-image构建阶段的参数，而非运行时参数，这是常见的操作误区。

2. 构建时固化系统属性到Native Image

如果希望配置永久生效，无需每次运行都传递参数，可以创建运行时配置文件（例如runtime-config.json）：

{
  "systemProperties": {
    "java.security.krb5.conf": "/opt/kevin/krb5/krb5.conf"
  }
}

然后在构建native-image时添加参数引用该文件：

-H:RuntimeConfigurationFiles=/home/runner/work/SingleQueryExecutor/src/main/resources/META-INF/native-images/runtime-config.json

构建完成后，生成的二进制文件会默认使用该配置。

3. 代码中显式设置系统属性

在程序main方法的最开始处、Kerberos初始化之前，显式设置系统属性，确保优先级最高：

public class SingleQueryExecutor {
    public static void main(String[] args) throws ClassNotFoundException {
        // 显式指定Kerberos配置文件路径
        System.setProperty("java.security.krb5.conf", "/opt/kevin/krb5/krb5.conf");
        
        // 原有业务代码
        String url = "jdbc:sqlserver://somehost:1433;DatabaseName=somedb;...";
        Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
        // ...
    }
}

这种方式彻底规避Native Image的属性传递问题，缺点是配置硬编码，需要切换配置时需重新构建程序。

额外注意事项 #

• 确保目标机器上/opt/kevin/krb5/krb5.conf文件存在，且运行程序的用户拥有读取权限。
• KRB5_CONFIG环境变量在Native Image中可能因底层实现限制无法生效，优先使用Java属性或代码显式设置的方式。
• 建议使用最新稳定版GraalVM，旧版本可能存在系统属性传递的已知bug。

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