Tomcat9配置JDBC资源后Spring Boot JNDI查找报NoInitialContextException如何解决

核心根因说明 #

你遇到的javax.naming.NoInitialContextException异常本质是当前运行环境没有初始化Tomcat的JNDI上下文，无法识别Tomcat配置的全局资源，按以下顺序排查即可： #

1. 确认应用运行方式 #

你当前的测试代码写在Spring Boot的main方法中，如果是直接在IDE执行main方法启动，默认使用Spring Boot内置的Tomcat容器，不会读取你系统中/var/lib/tomcat9/目录下的配置文件，自然找不到配置的JNDI资源。
两种适配方案：

• 方案一（推荐）：将Spring Boot应用打包为war包，部署到你已配置好的/var/lib/tomcat9/实例中运行，不要直接执行main方法
• 方案二：如果要使用内置Tomcat调试，需要额外配置内置Tomcat启用JNDI并注册数据源，添加如下配置类即可：

import org.apache.catalina.Context;
import org.apache.catalina.deploy.ContextResource;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.sql.DataSource;

@Configuration
public class JndiConfig {
    @Bean
    public TomcatServletWebServerFactory tomcatFactory() {
        return new TomcatServletWebServerFactory() {
            @Override
            protected void postProcessContext(Context context) {
                ContextResource resource = new ContextResource();
                resource.setName("jdbc/myservice");
                resource.setType(DataSource.class.getName());
                resource.setProperty("driverClassName", "org.postgresql.Driver");
                resource.setProperty("url", "jdbc:postgresql://localhost:5432/myservice");
                resource.setProperty("username", "你的数据库用户名");
                resource.setProperty("password", "你的数据库密码");
                resource.setProperty("maxTotal", "25");
                resource.setProperty("maxIdle", "10");
                resource.setProperty("validationQuery", "select 1");
                context.getNamingResources().addResource(resource);
            }
        };
    }
}

2. 补充JNDI上下文初始化参数 #

如果部署到外部Tomcat后仍报错，需要显式指定JNDI工厂类，两种配置方式：

• 代码中初始化上下文时传入参数：

Properties env = new Properties();
env.put(Context.INITIAL_CONTEXT_FACTORY, "org.apache.naming.java.javaURLContextFactory");
env.put(Context.URL_PKG_PREFIXES, "org.apache.naming");
InitialContext cxt = new InitialContext(env);
DataSource ds = (DataSource) cxt.lookup( "java:/comp/env/jdbc/myservice" );

• 或者在项目src/main/resources目录下添加jndi.properties文件，内容如下：

java.naming.factory.initial=org.apache.naming.java.javaURLContextFactory
java.naming.factory.url.pkgs=org.apache.naming

3. 检查驱动包部署位置 #

容器管理的JNDI数据源依赖的JDBC驱动包必须放到Tomcat的lib目录（即/var/lib/tomcat9/lib/），不能放在应用自身的WEB-INF/lib下，否则Tomcat初始化数据源时会找不到驱动类。 #

4. 验证配置正确性 #

• 确认server.xml中Resource配置的username、password参数已正确填写，数据库地址、端口、库名无误，数据库账号有对应访问权限
• 确认你修改的server.xml、context.xml是当前正在运行的Tomcat实例的配置文件，避免错改其他版本Tomcat的配置

5. Spring Boot 整合JNDI简化配置 #

无需手动编写InitialContext查找代码，直接在application.properties中添加如下配置即可自动注入数据源：

spring.datasource.jndi-name=java:/comp/env/jdbc/myservice

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