Docker部署Tomcat多WAR包时JNDI数据源绑定失败问题求助

问题核心 #

报错的本质是全局JNDI资源app1未完成注册，导致war1.xml中的ResourceLink无法找到对应绑定。结合Docker部署场景，从以下几个维度排查修复：

解决方案步骤 #

1. 配置Tomcat全局数据源 #

Tomcat的全局JNDI资源必须在conf/server.xml或conf/context.xml中声明，仅在应用上下文配置里加ResourceLink无效。

• 编辑Tomcat的conf/context.xml（Docker环境下需确保该文件被正确挂载或复制进容器），添加全局数据源配置：

<Resource
    name="app1"
    auth="Container"
    type="javax.sql.DataSource"
    driverClassName="com.mysql.cj.jdbc.Driver"
    url="jdbc:mysql://mysql:3306/app1_db?useSSL=false&serverTimezone=UTC"
    username="root"
    password="你的MySQL密码"
    maxTotal="100"
    maxIdle="20"
    maxWaitMillis="10000"
/>

注意：url中的mysql是Docker Compose里MySQL服务的名称，需保证两者在同一网络下连通。

2. 修正war1.xml的ResourceLink配置 #

确保ResourceLink的global属性与全局资源名称完全匹配，name对应应用内使用的JNDI名称：

<Context>
    <ResourceLink name="jdbc/app1" global="app1" type="javax.sql.DataSource"/>
</Context>

3. 确保Docker环境下配置与依赖加载正确 #

在Tomcat Dockerfile中，需将所有自定义配置、WAR包、驱动文件复制到对应路径：

FROM tomcat:9-jdk11
# 覆盖全局上下文配置
COPY ./context.xml /usr/local/tomcat/conf/context.xml
# 复制应用上下文配置
COPY ./war1.xml /usr/local/tomcat/conf/Catalina/localhost/war1.xml
COPY ./war2.xml /usr/local/tomcat/conf/Catalina/localhost/war2.xml
# 部署WAR包
COPY ./war1.war /usr/local/tomcat/webapps/war1.war
COPY ./war2.war /usr/local/tomcat/webapps/war2.war
# 复制MySQL驱动（Tomcat镜像默认不带，必须放在lib目录）
COPY ./mysql-connector-java-8.0.30.jar /usr/local/tomcat/lib/

4. 调整Docker Compose的依赖与网络 #

确保Tomcat在MySQL完全就绪后启动，且网络连通：

version: '3.8'
services:
  mysql:
    build: ./mysql
    environment:
      MYSQL_ROOT_PASSWORD: 你的密码
      MYSQL_DATABASE: app1_db
    volumes:
      - mysql_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 5s
      retries: 5
  tomcat:
    build: ./tomcat
    ports:
      - "8080:8080"
    depends_on:
      mysql:
        condition: service_healthy
    volumes:
      - tomcat_logs:/usr/local/tomcat/logs
volumes:
  mysql_data:
  tomcat_logs:

5. 验证配置有效性 #

启动容器后，查看Tomcat日志（docker logs <tomcat容器ID>），若出现Initializing processed DataSource相关日志且无报错，说明全局资源注册成功。

常见误区排查 #

• 不要把全局Resource配置写在应用的war1.xml里，该文件中的Resource是应用局部资源，不属于全局范围。
• Docker环境下需确保配置文件权限正确，Tomcat用户具备读取权限。
• MySQL驱动版本要与MySQL服务版本匹配（如MySQL 8.x需用8.x版本的驱动）。

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