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 显式标记为
jakarta.ws.rs jakarta.ws.rs-api 2.1.6 provided org.jboss.resteasy resteasy-hibernatevalidator-provider 4.7.13.Final provided jakarta.validation jakarta.validation-api 2.0.2 provided
? 验证提示：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 扫描日志：
可观察是否打印 Registered provider ... 日志。
✅ 最终效果
修复后，RESTEasy 将在启动时成功扫描并注册你的 ValidationExceptionHandler，所有抛出 MethodConstraintViolationException 的资源方法，均能触发 toResponse() 方法，返回自定义响应。
? 总结：容器环境中的“API 依赖 = provided” 是铁律。不要让应用“自带标准”，而应信任容器提供稳定、兼容、经过集成测试的实现。一次正确的 scope 修正，胜过十次调试日志排查。
