GraalVM Native+Kotlin开发遇UnsupportedCharsetException: CP1252问题求助

问题场景 #

使用Kotlin编写应用，通过GraalVM编译为原生程序后，使用Apache POI打开Excel文件时抛出UnsupportedCharsetException: CP1252异常，但在JVM模式（包括GraalVM的VM模式）下运行正常。

异常堆栈片段：

java.lang.ExceptionInInitializerError: null
        at org.apache.poi.poifs.filesystem.FileMagic.<init>(FileMagic.java:133) ~[pikr:5.2.3]
        at org.apache.poi.poifs.filesystem.FileMagic.<clinit>(FileMagic.java:74) ~[pikr:5.2.3]

POI触发异常的相关代码：

FileMagic(String... magic) {
    this.magic = new byte[magic.length][];
    int i=0;
    for (String s : magic) {
        this.magic[i++] = s.getBytes(LocaleUtil.CHARSET_1252);
    }
}

原因分析 #

JVM运行时会动态加载所需的字符集，即使是CP1252这类扩展字符集，也能在用到时自动加载，因此VM模式下无异常。但GraalVM原生镜像采用静态编译，仅将静态分析阶段能检测到的程序依赖打包进原生程序。

Apache POI中通过LocaleUtil.CHARSET_1252引用CP1252字符集，这种隐式依赖无法被GraalVM的静态分析工具识别，导致原生程序中未包含该字符集。当运行到s.getBytes(LocaleUtil.CHARSET_1252)时，由于字符集不存在，直接抛出UnsupportedCharsetException。

解决方法 #

方法1：编译时显式指定包含CP1252 #

生成原生镜像时，添加参数强制包含CP1252字符集：

native-image -H:IncludeCharsets=CP1252 [其他编译参数] 你的主类全限定名

如果需要支持更多扩展字符集，可使用-H:+AddAllCharsets（会增大程序体积，按需使用）。

方法2：代码中显式触发CP1252加载 #

在应用启动入口处显式加载CP1252字符集，让GraalVM静态分析能检测到该依赖：

fun main() {
    // 显式加载CP1252，确保编译时被包含
    Charset.forName("CP1252")
    // 后续业务逻辑
}

方法3：提前初始化POI的LocaleUtil #

通过提前初始化POI的LocaleUtil类，触发字符集的加载逻辑：

fun main() {
    LocaleUtil.initialize()
    // 后续业务逻辑
}

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