SpringBoot WAR包独立运行时JNDI数据源无法正常工作

这个问题的核心在于嵌入式Tomcat与外部应用服务器的JNDI配置逻辑完全不同，加上你把Tomcat依赖设为provided后，独立运行时的环境和部署到服务器时的环境存在依赖和配置差异，咱们一步步来解决：

1. 修正Tomcat依赖的Scope配置 #

你现在把嵌入式Tomcat的scope设为provided，会导致独立运行时classpath里没有Tomcat依赖，连嵌入式服务器都启动不了（或者启动异常）。正确的做法是区分打包场景：

• 当打包成WAR用于部署到外部应用服务器时，排除嵌入式Tomcat；
• 当需要独立运行（java -jar）时，保留嵌入式Tomcat依赖。

在pom.xml里这么配置：

<!-- 基础的web starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- 嵌入式Tomcat，默认compile，打包WAR时改为provided -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-tomcat</artifactId>
    <scope>provided</scope>
</dependency>

<!-- 添加maven-war-plugin，打包时自动处理依赖 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version>
            <configuration>
                <!-- 这样打包出来的WAR既可以部署到服务器，也可以用java -jar直接运行 -->
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

这样配置后，mvn package打出的WAR包，内部会包含SpringBoot的启动器，用java -jar运行时会自动加载嵌入式Tomcat，而部署到外部服务器时，服务器会忽略provided的Tomcat依赖，用自身的容器。

2. 为嵌入式Tomcat配置JNDI数据源 #

独立运行时，嵌入式Tomcat默认没有JNDI上下文，你需要手动在代码中注册数据源到JNDI里，同时和应用服务器的JNDI配置做环境区分：

步骤2.1 创建环境区分的配置类 #

用Spring的@Profile注解区分"standalone"（独立运行）和"server"（部署到应用服务器）环境：

import org.apache.tomcat.util.descriptor.web.ContextResource;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.servlet.server.ServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.jndi.JndiObjectFactoryBean;
import org.springframework.beans.factory.annotation.Value;

import javax.sql.DataSource;

@Configuration
public class JndiConfig {

    // 部署到应用服务器时使用：直接从服务器JNDI获取数据源
    @Profile("server")
    @Bean
    public DataSource jndiDataSource() {
        JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();
        jndiObjectFactoryBean.setJndiName("java:comp/env/jdbc/YourDataSource"); // 对应服务器配置的JNDI名称
        jndiObjectFactoryBean.setResourceRef(true);
        jndiObjectFactoryBean.afterPropertiesSet();
        return (DataSource) jndiObjectFactoryBean.getObject();
    }

    // 独立运行时使用：在嵌入式Tomcat中注册JNDI数据源
    @Profile("standalone")
    @Bean
    public ServletWebServerFactory servletWebServerFactory(
            @Value("${standalone.datasource.url}") String dbUrl,
            @Value("${standalone.datasource.username}") String dbUser,
            @Value("${standalone.datasource.password}") String dbPwd,
            @Value("${standalone.datasource.driver-class-name}") String driverClass) {
        
        TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory() {
            @Override
            protected void postProcessContext(org.apache.catalina.Context context) {
                ContextResource resource = new ContextResource();
                resource.setName("jdbc/YourDataSource");
                resource.setType(DataSource.class.getName());
                resource.setProperty("driverClassName", driverClass);
                resource.setProperty("url", dbUrl);
                resource.setProperty("username", dbUser);
                resource.setProperty("password", dbPwd);

                context.getNamingResources().addResource(resource);
            }
        };
        // 启用嵌入式Tomcat的JNDI支持
        tomcat.addContextCustomizers(context -> context.setResourceLink("java:comp/env/jdbc/YourDataSource", "jdbc/YourDataSource"));
        return tomcat;
    }

    // 独立运行时，从嵌入式Tomcat的JNDI获取数据源
    @Profile("standalone")
    @Bean
    public DataSource standaloneJndiDataSource() {
        JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();
        jndiObjectFactoryBean.setJndiName("java:comp/env/jdbc/YourDataSource");
        jndiObjectFactoryBean.setResourceRef(true);
        jndiObjectFactoryBean.afterPropertiesSet();
        return (DataSource) jndiObjectFactoryBean.getObject();
    }
}

步骤2.2 配置application.properties #

在application.properties里设置默认的profile，同时配置独立运行时的数据库信息：

# 默认用独立运行的profile，部署到服务器时可以通过服务器参数改成server
spring.profiles.active=standalone

# 独立运行时的数据库配置
standalone.datasource.url=jdbc:mysql://localhost:3306/your_db
standalone.datasource.username=root
standalone.datasource.password=your_password
standalone.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

3. 启动时指定Profile #

• 独立运行：直接运行java -jar your-app.war，默认用standalone profile，嵌入式Tomcat会自动注册JNDI数据源；
• 部署到应用服务器：在服务器的启动参数里添加-Dspring.profiles.active=server，这样应用会直接从服务器的JNDI获取数据源，不需要嵌入式Tomcat的配置。

4. 验证配置 #

• 独立运行时，启动日志里应该能看到嵌入式Tomcat初始化JNDI资源的信息，数据源能正常连接数据库；
• 部署到应用服务器时，确保服务器已经配置了对应的JNDI数据源（比如Tomcat的context.xml里配置Resource），应用启动后能正常获取。

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