升级JEE依赖时Weld与Undertow的jakarta/javax命名空间冲突问题

问题根源 #

你遇到的是Java EE迁移到Jakarta EE过程中最常见的命名空间冲突问题：Weld 4.x属于Jakarta EE 9及以上版本的实现，全部Servlet API已经切换到jakarta.servlet包；而你当前引入的Undertow 2.x默认版本仍使用旧的javax.servlet包，二者的接口定义因为包名不同无法兼容，才会出现实现类没有正确实现接口的错误。

可行解决方案 #

• 方案1：降级Weld版本至3.x系列
  Weld 3.x版本基于Java EE 8规范开发，统一使用javax.servlet命名空间，完全兼容Undertow 2.x默认的javax.*依赖体系，和RestEasy 5.x的javax版本也能正常适配，不需要调整其他依赖即可解决冲突。
• 方案2：切换为Jakarta适配版Undertow
  Undertow 2.2.x及以上版本均提供了适配Jakarta EE 9+的特殊构建版本，你可以在依赖管理中排除resteasy-undertow传递引入的默认undertow-servlet，手动引入同版本、分类器为jakarta的undertow-servlet构件，即可匹配Weld 4.x的jakarta.*命名空间要求。
• 方案3：使用RestEasy的Jakarta变体
  RestEasy 5.x正式版及后续版本均提供了基于jakarta.*命名空间的构件，你可以替换当前的resteasy-undertow为对应Jakarta版本的构件，配套使用Weld 4.x和Jakarta版Undertow即可正常运行。
• 方案4：临时替换嵌入式服务器
  如果测试场景不需要强制使用Undertow，可以切换为Jetty 11+等已经完成Jakarta命名空间迁移的嵌入式服务器，规避Undertow默认版本的命名空间冲突问题。

疑问解答 #

升级到RestEasy 5.x并使用Weld的前提下完全可以正常使用Undertow，只需要按照上述方案统一所有Servlet相关依赖的命名空间即可，不需要替换Undertow。

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