非JavaEE应用服务器场景下，如何避免Jakarta API类重复冲突？

推荐的Jakarta API引入方式 #

• 优先使用独立的API规范构件，比如jakarta.ws.rs:jakarta.ws.rs-api这类单规范包，不要引入jakartaee-api这类“胖包”。独立包粒度更细，能精准控制你需要的API版本，不会把一堆无用类塞进类路径。

第三方库依赖冲突的处理原则 #

• 必须排除**“胖包”全规范包**。胖包里的类和独立API包完全重复，一旦版本不匹配，类路径上就会出现同一类的多个副本，运行时到底加载哪个全靠类加载顺序“碰运气”，很容易触发NoSuchMethodError这类难以排查的问题。
• 实际操作示例：如果某第三方库默认依赖了jakartaee-api，你要在Maven或Gradle里显式排除这个依赖，同时自行引入对应版本的独立API构件，保证整个项目里同一种API只有一个版本。

额外注意事项 #

• 所有Jakarta相关的独立API构件要保持版本统一，比如用Jakarta EE 10的话，JAX-RS、JPA、CDI这些API都要对应10版本的构件，别混着用不同版本。
• 定期用构建工具的依赖树命令排查，比如Maven的mvn dependency:tree，能快速发现隐藏的冲突依赖，提前解决问题。

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