Quarkus开发模式下veraPDF缺失类报错，为何仅该模式出现问题？

问题分析 #

报错核心是javax/activation/DataSource类找不到，根源在于Quarkus的依赖优化机制：Dev模式下，Quarkus会通过静态代码分析自动剔除未被检测到直接使用的依赖。而veraPDF内部通过JAXB动态加载javax.activation相关类，这种动态依赖无法被Quarkus的静态分析捕获，导致该依赖被从运行时类路径中移除。

测试阶段正常是因为Maven测试环境会加载所有配置的依赖（包括未被Quarkus优化的），而Dev模式使用的是经过Quarkus优化后的类路径。

解决方案 #

1. 显式指定依赖范围并强制Quarkus保留 #

确保javax.activation-api依赖的范围为runtime或compile，并通过Quarkus配置强制保留该依赖：

在pom.xml中添加依赖：

<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>javax.activation-api</artifactId>
    <version>1.2.0</version>
    <scope>runtime</scope>
</dependency>

在src/main/resources/application.properties中添加配置，避免Quarkus剔除依赖：

# 保留所有必要的运行时依赖，避免静态分析遗漏
quarkus.dependency-inclusion=required-and-provided

2. 添加Quarkus JAXB扩展（推荐） #

Quarkus对JAXB有专门的扩展支持，添加后会自动处理JAXB相关的依赖管理，避免手动配置的遗漏：

./mvnw quarkus:add-extension -Dextensions="jaxb"

添加该扩展后，Quarkus会自动引入正确的JAXB运行时依赖，并确保相关的javax.activation类被包含在运行时类路径中。

关于Quarkus集成veraPDF的实践 #

确实有开发者在Quarkus中成功集成veraPDF，核心要点就是处理好JAXB相关依赖的配置，避免Quarkus的依赖优化机制剔除必要的动态依赖。如果后续遇到其他类缺失问题，同样可以通过显式声明依赖或添加对应Quarkus扩展来解决。

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