jax-rs 自定义 `@provider`（如 `exceptionmapper`）在迁移到 jboss eap 7 + jdk 11 后失效，主因是依赖未正确声明为 `provided`，导致类加载冲突和注解不匹配。
在 Jakarta EE（原 Java EE）容器（如 JBoss EAP、WildFly、GlassFish）中，核心 API（如 JAX-RS、JAXB、Bean Validation 等）均由应用服务器自身提供。若在 pom.xml 中将这些 API 声明为 compile 或 runtime 作用域（即默认或未显式指定 provided），Maven 会将其打包进 WAR/EAR，造成以下严重问题：
- ✅ 类加载冲突：应用内嵌的 javax.ws.rs-api 与 JBoss 提供的 jakarta.ws.rs-api（或旧版 javax.ws.rs-api）可能版本/包名不一致；
- ❌ 注解失效：@Provider 注解来自你打包的 javax.ws.rs-api，而 JBoss 的 RESTEasy 扫描器只识别其自身类加载器中的 @Provider —— 二者虽同名，但属于不同类加载器，不视为同一类型，故 Provider 被完全忽略；
- ⚠️ 隐性兼容风险：resteasy-hibernatevalidator-provider、jaxb-api、jaxws-api 等同理，重复引入易引发 ClassCastException、NoSuchMethodError 或验证器未注册等问题。
✅ 正确的依赖配置（关键修正）
请将所有由容器提供的 Jakarta/Java EE API 显式标记为 <scope>provided</scope>：
<!-- JAX-RS API → 由 JBoss EAP 7+ 提供 -->
<dependency>
<groupId>jakarta.ws.rs</groupId>
<artifactId>jakarta.ws.rs-api</artifactId>
<version>2.1.6</version> <!-- 推荐使用 Jakarta 命名空间版本（EAP 7.3+ 默认） -->
<scope>provided</scope>
</dependency>
<!-- 注意：JDK 11+ 已移除 JAXB，但 JBoss EAP 7 内置实现，无需额外引入 -->
<!-- ❌ 删除或注释掉以下冗余依赖 -->
<!--
<dependency>
<groupId>javax.xml.bind</groupId>
<artifactId>jaxb-api</artifactId>
<version>2.3.1</version>
</dependency>
-->
<!-- Hibernate Validator（Bean Validation）Provider → 由 EAP 提供 -->
<dependency>
<groupId>org.jboss.resteasy</groupId>
<artifactId>resteasy-hibernatevalidator-provider</artifactId>
<version>4.7.13.Final</version> <!-- 匹配 EAP 7.4+ 的 RESTEasy 版本 -->
<scope>provided</scope>
</dependency>
<!-- Jakarta Validation API（替代旧 javax.validation） -->
<dependency>
<groupId>jakarta.validation</groupId>
<artifactId>jakarta.validation-api</artifactId>
<version>2.0.2</version>
<scope>provided</scope>
</dependency>? 验证提示：JBoss EAP 7.3+ 默认使用 Jakarta EE 8 规范，包名已从 javax.* 迁移至 jakarta.*。若你仍使用 javax.ws.rs-api，请确认 EAP 版本是否支持（EAP 7.2 及更早仍用 javax）；否则应统一升级为 jakarta.ws.rs-api，并确保你的 ValidationExceptionHandler 使用对应包下的 @Provider 和 ExceptionMapper。
? 补充检查项
- Provider 类必须无参公开构造函数（默认即满足），且不能被 Spring 等框架托管（避免双重注册或代理干扰）；
- 确保类位于 WEB-INF/classes 下（非 jar 内部），或通过 META-INF/services/jakarta.ws.rs.ext.Provider 文件显式声明（较少用）；
- 检查日志级别设为 DEBUG，启用 RESTEasy 扫描日志：
<!-- 在 standalone.xml 或 logging subsystem 中添加 --> <logger category="org.jboss.resteasy"> <level name="DEBUG"/> </logger>可观察是否打印 Registered provider ... 日志。
✅ 最终效果
修复后，RESTEasy 将在启动时成功扫描并注册你的 ValidationExceptionHandler，所有抛出 MethodConstraintViolationException 的资源方法，均能触发 toResponse() 方法，返回自定义响应。
? 总结：容器环境中的“API 依赖 = provided” 是铁律。不要让应用“自带标准”，而应信任容器提供稳定、兼容、经过集成测试的实现。一次正确的 scope 修正，胜过十次调试日志排查。
