Tomcat8下Servlet的@Resource注解Java8生效Java11失效及JMS兼容问题

Java 11下@Resource注解失效的成因 #

你提供的注入代码如下：

@Resource(name = "jms/ConnectionFactory")
private ConnectionFactory connectionFactory;

该问题的核心原因是JDK版本迭代后的模块化拆分：

• Java 8及更早版本中，javax.annotation.Resource属于JDK内置核心类，编译时会默认保留该注解的运行时元信息，Servlet容器可以识别注解并完成资源注入。
• Java 9引入模块化系统后，所有Java EE相关的类都被移出JDK核心模块，javax.annotation相关类被归入非默认加载的可选模块java.xml.ws.annotation；到Java 11版本，JDK已经完全移除了所有Java EE相关的内置模块。
• 若使用Java 11编译时没有显式引入javax.annotation-api依赖，也没有在编译参数中指定加载java.xml.ws.annotation模块，编译器会将无法识别的@Resource作为无效注解直接忽略，不会在生成的Class文件中保留该注解的元信息，因此容器不会执行自动注入。
• 你可以主动通过JNDI查找到资源的原因是context.xml中的资源配置本身有效，和注解是否生效无关，只要调用对应的JNDI查找接口就能拿到对应实例。

javax.jms与Jakarta EE命名空间兼容性说明 #

不需要重新实现现有JMS相关库，该场景下的兼容性表现和适配方案如下：

• 若你仍在使用Java EE 8及更低版本的容器（如Tomcat 9及更低版本），原有基于javax.jms.*的JMS实现库可以完全正常运行，不需要做任何调整。
• 若你需要迁移到Jakarta EE 9及更高版本的容器，有两类成熟的适配方案可以选择，无需修改JMS库的底层实现：
  • 依赖容器内置转换层：绝大多数主流Jakarta EE容器（Tomcat 10+、Jetty 11+、WildFly 26+等）都内置了javax到jakarta命名空间的字节码转换层，会自动把应用代码和依赖库中的javax.jms引用转换为jakarta.jms的对应类，无感知完成兼容。
  • 替换适配版本依赖：当前绝大多数主流MQ厂商都已经推出了JMS客户端的Jakarta专属版本，或者提供了同时支持两套命名空间的客户端版本，仅需替换依赖坐标即可完成适配，不需要修改任何业务逻辑代码。

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