Spring Boot配置JNDI数据源失败 Tomcat启动报错问题排查

你的配置存在4个核心错误，直接触发JNDI查找失败、Tomcat启动异常：

• JNDI资源名三处不匹配：Tomcat上下文注册的资源名是jdbc/ActiveIDB，application.properties配置的查找名是jdbc/IDB，自定义DataSource Bean里写的查找名是java:comp/env/jdbc/IDB，名称完全不一致，就算上下文正常启动也找不到对应资源。
• 内嵌Tomcat依赖配置错误：你把spring-boot-starter-tomcat、tomcat-embed-jasper的依赖范围设为provided，如果是本地通过main方法启动内嵌Tomcat（不是打WAR包丢外部Tomcat部署），provided范围的依赖不会加入运行时类路径，直接导致Tomcat的JNDI初始上下文工厂类缺失，抛出NoInitialContextException。
• 数据源配置冲突：application.properties里同时配置了JNDI查找名和直连所需的url、用户名、密码、驱动类参数，Spring Boot自动配置逻辑冲突，无法判定该走JNDI查找还是直接创建连接池。
• JNDI查找时机错误：自定义DataSource Bean时设置lookupOnStartup=false又立刻手动调用afterPropertiesSet()触发查找，此时Tomcat的Naming上下文还没完成初始化，根本无法获取资源。

1. 修正pom.xml依赖范围 #

本地用内嵌Tomcat启动时，去掉Tomcat相关依赖的provided scope，避免运行时类缺失；如果后续要打WAR包部署到外部Tomcat，可通过Maven profile在打包阶段再切换scope为provided。修正后的依赖如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jdbc</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>
<!-- 本地启动内嵌Tomcat不需要设provided，spring-boot-starter-web会传递引入starter-tomcat，无需重复声明 -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
</dependency>
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.2.25</version>
</dependency>

2. 清理application.properties冗余配置 #

走JNDI模式时不需要配置直连参数，删掉所有冲突项，只保留必要配置即可：

# JNDI查找全路径
spring.datasource.jndi-name=java:comp/env/jdbc/IDB
spring.jmx.enabled=false

3. 修正Tomcat JNDI配置，删除手动定义的DataSource Bean #

统一JNDI资源名称，删掉你之前写的dataSource()@Bean方法——Spring Boot会自动根据配置的JNDI名查找资源，手动定义反而会因为Bean初始化顺序提前触发查找，引发上下文未就绪问题。修正后的Tomcat配置如下：

@Bean
public TomcatServletWebServerFactory tomcatFactory() {
    return new TomcatServletWebServerFactory() {
        @Override
        protected TomcatWebServer getTomcatWebServer(Tomcat tomcat) {
            // Tomcat实例初始化前开启JNDI命名支持
            tomcat.enableNaming();
            // 原有静态资源映射逻辑无需要可删除
            try {
                tomcat.addContext("/aiv/appimages", imgLoc);
            } catch (Exception e) {
                e.printStackTrace();
            }
            return super.getTomcatWebServer(tomcat);
        }

        @Override
        protected void postProcessContext(org.apache.catalina.Context context) {
            ContextResource resource = new ContextResource();
            // 资源名和配置文件里的JNDI名对应，不需要加java:comp/env/前缀，Tomcat会自动绑定到该命名空间
            resource.setName("jdbc/IDB");
            resource.setType(DataSource.class.getName());
            resource.setProperty("driverClassName", "org.postgresql.Driver");
            resource.setProperty("url", "jdbc:postgresql://localhost:5432/postgres");
            resource.setProperty("username", "postgres");
            resource.setProperty("password", "ROOT");
            // 补充连接池基础参数
            resource.setProperty("initialSize", "5");
            resource.setProperty("maxTotal", "20");
            resource.setProperty("maxIdle", "10");
            resource.setProperty("minIdle", "5");
            context.getNamingResources().addResource(resource);
        }
    };
}

改完以上配置后重启应用即可正常启动，JNDI数据源会在Tomcat上下文初始化完成后被正确绑定，不会再抛出初始上下文不存在的异常。

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