升级Wildfly至29.0.1时PDFBox出现初始化异常/空指针问题

问题根源 #

WildFly 29调整了日志模块的类加载隔离策略，PDFBox 3.0.0-alpha依赖的Commons Logging在类初始化阶段无法正常获取Logger实例，导致org.apache.pdfbox.io.IOUtils.LOG字段为null，触发NullPointerException和ExceptionInInitializerError，最终引发NoClassDefFoundError。

解决方案 #

1. 优先升级PDFBox至稳定版本 #

3.0.0-alpha属于预览版，存在已知的类加载和日志依赖兼容性问题。建议升级到3.0.x稳定版本（如3.0.2及以上），官方已修复此类初始化问题，无需额外配置即可适配WildFly 29。

2. 配置WildFly部署结构，显式引入Commons Logging模块 #

在应用的jboss-deployment-structure.xml中添加模块依赖，确保应用能正确加载容器提供的Commons Logging实例：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <!-- 显式依赖WildFly的Commons Logging模块 -->
            <module name="org.apache.commons.logging" export="true"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

3. 替换PDFBox的日志依赖为SLF4J（适配WildFly日志系统） #

通过Maven/Gradle排除Commons Logging依赖，改用SLF4J桥接WildFly的JBoss Logging：

Maven依赖配置：

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>3.0.0-alpha</version>
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- SLF4J API -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>2.0.7</version>
</dependency>
<!-- SLF4J桥接JBoss Logging -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jboss-logging</artifactId>
    <version>2.0.7</version>
</dependency>

4. 验证WildFly日志模块配置 #

检查WildFly的modules/system/layers/base/org/apache/commons/logging/module.xml，确保模块配置正确；同时在standalone.xml/domain.xml的日志子系统中，确认commons-logging桥接已启用：

<subsystem xmlns="urn:jboss:domain:logging:8.0">
    <!-- 确保存在以下配置 -->
    <logger category="org.apache.commons.logging">
        <level name="INFO"/>
    </logger>
</subsystem>

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