GraalVM原生编译Apache POI应用时出现log4j无构造方法异常

问题概述 #

开发集成Picocli与Apache POI的Java应用，使用Gradle结合GraalVM 21.0.2-graalce执行原生编译（命令：./gradlew clean build nativeCompile）后，运行编译产物抛出java.lang.NoSuchMethodException: org.apache.logging.log4j.message.DefaultFlowMessageFactory.<init>()异常，非原生编译运行正常。尝试排除Apache POI依赖的log4j-api、引入log4j-over-slf4j均未解决问题，需寻求可行方案。

问题根源 #

1. GraalVM反射限制：Log4j初始化时通过反射实例化DefaultFlowMessageFactory，但GraalVM原生编译默认不会将反射用到的类构造方法纳入镜像，导致运行时无法找到默认构造方法。
2. 日志依赖桥接不彻底：直接排除POI的Log4j依赖后，POI内部硬编码的Log4j API调用未被完全转发到SLF4J，导致桥接失效。

可行解决方案 #

方案一：添加GraalVM反射配置 #

通过显式配置告诉GraalVM原生编译时包含DefaultFlowMessageFactory的构造方法：

1. 在项目中创建配置文件路径：src/main/resources/META-INF/native-image/com.example/native-compile-example/reflect-config.json
2. 写入以下配置内容：

[
  {
    "name": "org.apache.logging.log4j.message.DefaultFlowMessageFactory",
    "allDeclaredConstructors": true,
    "allPublicConstructors": true
  }
]

3. 重新执行原生编译命令，运行产物即可验证。

方案二：完整替换POI的日志实现为SLF4J #

彻底替换POI的日志依赖链，将Log4j调用桥接到SLF4J：
修改build.gradle的dependencies块：

dependencies {
    implementation 'info.picocli:picocli:4.7.5'
    annotationProcessor 'info.picocli:picocli-codegen:4.7.5'

    // 排除POI自带的Log4j依赖
    implementation('org.apache.poi:poi:5.2.5') {
        exclude group: 'org.apache.logging.log4j', module: 'log4j-api'
        exclude group: 'org.apache.logging.log4j', module: 'log4j-core'
    }
    implementation('org.apache.poi:poi-ooxml:5.2.5') {
        exclude group: 'org.apache.logging.log4j', module: 'log4j-api'
        exclude group: 'org.apache.logging.log4j', module: 'log4j-core'
    }

    // SLF4J核心API
    implementation 'org.slf4j:slf4j-api:2.0.9'
    // 轻量SLF4J实现（生产环境可替换为logback等）
    implementation 'org.slf4j:slf4j-simple:2.0.9'
    // 桥接Log4j调用到SLF4J
    implementation 'org.slf4j:log4j-over-slf4j:2.0.9'
}

重新执行原生编译命令，此时POI的日志调用会完全通过SLF4J处理，避开Log4j的反射初始化问题。

方案三：自定义空实现替换（备选，不推荐） #

若前两种方案无效，可自定义空实现替换原类：

1. 创建org.apache.logging.log4j.message.DefaultFlowMessageFactory类：

package org.apache.logging.log4j.message;

public class DefaultFlowMessageFactory implements FlowMessageFactory {
    public DefaultFlowMessageFactory() {}

    @Override
    public Message createEntryMessage(String message) {
        return new SimpleMessage(message);
    }

    @Override
    public Message createExitMessage(String message) {
        return new SimpleMessage(message);
    }

    @Override
    public Message createExitMessage(Message message, Throwable throwable) {
        return new SimpleMessage(message.getFormattedMessage());
    }
}

2. 通过GraalVM配置指定替换原类，创建src/main/resources/META-INF/native-image/com.example/native-compile-example/reachability-metadata.json并配置类替换规则（需确保所有方法签名匹配，易出问题，仅作最后备选）。

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