Tomcat部署/webapp-session上下文启动失败求助

问题概述 #

• 应用部署后提示：FAILURE - Application deployed to context path [/webapp-session], but the context failed to start
• Tomcat无法扫描WEB-INF/lib下多个JAR包（如jakarta.servlet.jsp.jstl-2.0.0.jar、jakarta.activation-2.0.0.jar、jackson-core-2.12.3.jar），问题触发于配置JNDI DataSource连接池之后

报错日志 #

29-Jun-2024 11:14:04.656 WARNING [http-nio-8080-exec-8] org.apache.tomcat.util.scan.StandardJarScanner.scan Failed to scan JAR [war:file:/C:/Users/Gateway/Desktop/Lenguajes%20de%20programacion/Master%20Java/JavaEE/apache-tomcat-11.0.0-M20/webapps/webapp-session.war*/WEB-INF/lib/jackson-core-2.12.3.jar] from /WEB-INF/lib

数据库连接工具类代码 #

public class ConexionBaseDatosDS {

    public static Connection getConnection() throws SQLException, NamingException {
        Context initContext = null;
        initContext = new InitialContext();
        Context envContext = (Context) initContext.lookup("java:/comp/env");
        DataSource ds = (DataSource) envContext.lookup("jdbc/mysqlDB");
        return ds.getConnection();

    }
}

排查与解决步骤 #

1. 修复JAR包扫描失败问题 #

• 校验J包完整性：重新下载jakarta.servlet.jsp.jstl-2.0.0.jar、jakarta.activation-2.0.0.jar、jackson-core-2.12.3.jar，替换WEB-INF/lib下的文件，避免因文件损坏导致扫描失败。
• 适配Tomcat版本：当前使用Tomcat 11（基于Jakarta EE 10），需确保依赖包版本兼容：
  • jackson-core建议升级至2.15+版本，避免低版本与Jakarta EE 10的API冲突
  • 确认jakarta.servlet.jsp.jstl包含API包与实现包，避免仅引入单一JAR
• 配置扫描过滤：在Tomcat的conf/context.xml或项目META-INF/context.xml中添加配置，跳过无法扫描的JAR：

  <Context>
      <JarScanner>
          <JarScanFilter defaultPluggabilityScan="false"
                         tldSkip="jakarta.servlet.jsp.jstl-2.0.0.jar,jakarta.activation-2.0.0.jar,jackson-core-2.12.3.jar"/>
      </JarScanner>
  </Context>
  

2. 校验JNDI DataSource配置 #

• 检查DataSource配置：在Tomcatconf/context.xml或项目META-INF/context.xml中确认配置完整：

  <Resource name="jdbc/mysqlDB"
            auth="Container"
            type="javax.sql.DataSource"
            driverClassName="com.mysql.cj.jdbc.Driver"
            url="jdbc:mysql://localhost:3306/你的数据库名?useSSL=false&amp;serverTimezone=UTC"
            username="数据库用户名"
            password="数据库密码"
            maxTotal="100"
            maxIdle="30"
            maxWaitMillis="10000"/>
  

• 确认数据库驱动：WEB-INF/lib下需包含对应版本的MySQL驱动JAR（如mysql-connector-java-8.0.x.jar），版本需与MySQL服务器匹配。
• 检查文件权限：确保Tomcat进程有权限访问war包解压后的WEB-INF/lib目录，无文件锁定或权限不足情况。

3. 定位核心错误 #

当前仅提供警告日志，应用启动失败的核心原因需查看Tomcatlogs/catalina.out或localhost.log中的SEVERE级日志，通过异常栈定位具体问题（如类找不到、配置语法错误等）。

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