Tomcat10+Jersey3下@Resource注解注入JNDI数据源始终为null报NPE

JNDI lookup与mappedName的匹配规则 #

• Tomcat容器中，项目级context.xml定义的资源，默认挂载在当前Web应用的java:comp/env命名空间下，不存在特殊配置的前提下，不会自动暴露到根命名空间
• @Resource注解的匹配优先级从高到低为：
  1. 优先读取lookup属性值，按照完整JNDI路径做精准查找
  2. 若未配置lookup，才会读取mappedName属性，将其作为全局资源名做查找，不会自动拼接java:comp/env前缀
  3. 若两个属性都未配置，会默认按照注入字段的名称拼接java:comp/env前缀做查找，匹配失败则返回null
• 常见配置误区：
  • 直接使用java:/jdbc/myDB作为lookup值查找失败：该路径属于Tomcat全局命名空间，若未通过将全局资源映射到应用的comp/env命名空间，应用层无权限访问该路径
  • 使用mappedName="jdbc/myDB"查找失败：Tomcat对该属性的处理逻辑是直接查找全局命名空间下的同名资源，不会自动拼接应用命名空间前缀，和多数教程的描述存在差异

核心失效原因排查 #

• Jersey3默认无Servlet容器资源注入能力
  Jersey3的控制器实例由内置HK2容器创建和管理，完全脱离Tomcat的Servlet组件生命周期管理范围。若未引入桥接逻辑，Tomcat不会对Jersey创建的实例执行注解扫描和资源填充，是注入为null的最高发原因。
  对应验证逻辑：若手动编写JNDI查找代码可正常获取DataSource，即可确认是Jersey注入桥接缺失导致的注解失效。
• context.xml位置错误
  项目级context.xml必须放置在WEB-INF/classes/META-INF/路径下，打包为war包后需确保文件路径为WEB-INF/classes/META-INF/context.xml，放置路径错误会导致Tomcat完全不加载该配置，资源无法正常注册。
• ResourceLink配置缺失
  若节点配置了global属性将资源注册到全局命名空间，必须在同一context.xml内补充节点，将全局资源映射到当前应用的java:comp/env命名空间下，否则即便资源注册成功，应用层也无法访问。
  正确的context.xml配置参考：

  <Context>
    <Resource 
      name="jdbc/myDB"
      global="jdbc/myDB"
      type="javax.sql.DataSource"
      maxTotal="20"
      driverClassName="oracle.jdbc.OracleDriver"
      url="jdbc:oracle:thin:@db-host:1521:sid"
      username="db_user"
      password="db_pwd"
    />
    <ResourceLink 
      name="jdbc/myDB"
      global="jdbc/myDB"
      type="javax.sql.DataSource"
    />
  </Context>
  

最稳妥的配置写法 #

• 针对上述context.xml配置，使用@Resource注解时优先指定完整lookup路径，避免依赖默认拼接逻辑：

  @Resource(lookup = "java:comp/env/jdbc/myDB")
  private DataSource dataSource;
  

• 若Jersey注入桥接配置成本较高，可直接在应用初始化阶段手动完成JNDI查找获取DataSource实例，规避自动注入的兼容问题。

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