Java Web应用启动失败：IllegalStateException及MySQL线程问题求助

核心问题分析 #

这个异常和内存泄漏警告的本质是：Web应用停止后仍有后台线程（JDBC连接清理线程）持续运行，导致Tomcat重启/加载阶段出现资源冲突，同时Hibernate在应用已停止的状态下尝试加载类或资源，触发非法访问异常。

具体修复步骤 #

1. 解决JDBC驱动内存泄漏 #

Tomcat 9对Web应用类加载隔离要求严格，若JDBC驱动放在WEB-INF/lib下，会被注册到系统类加载器，应用停止后无法正常注销，进而引发线程泄漏。

• 修复方案：
  • 将mysql-connector-java.jar从项目的WEB-INF/lib迁移到Tomcat的lib目录。在Docker环境中，可通过Dockerfile添加COPY指令：

    COPY mysql-connector-java-*.jar /usr/local/tomcat/lib/
    

  • 或者在Tomcat的conf/context.xml中配置JNDI数据源，避免驱动由Web应用类加载器加载：

    <Resource name="jdbc/YourDB"
              auth="Container"
              type="javax.sql.DataSource"
              driverClassName="com.mysql.cj.jdbc.Driver"
              url="jdbc:mysql://db:3306/your_db?useSSL=false&amp;serverTimezone=UTC"
              username="root"
              password="your_password"
              maxTotal="100"
              maxIdle="20"
              maxWaitMillis="10000"/>
    

  • 同步修改Hibernate配置，改用JNDI数据源：

    <property name="hibernate.connection.datasource">java:comp/env/jdbc/YourDB</property>
    

2. 手动停止MySQL连接清理线程 #

在Web应用中添加ServletContextListener，在应用销毁时强制停止mysql-cj-abandoned-connection-cleanup线程：

public class AppContextListener implements ServletContextListener {
    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        // 停止MySQL连接清理线程
        try {
            Class<?> cleanupClass = Class.forName("com.mysql.cj.jdbc.AbandonedConnectionCleanupThread");
            Method shutdownMethod = cleanupClass.getMethod("shutdown");
            shutdownMethod.invoke(null);
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 关闭Hibernate SessionFactory
        SessionFactory sessionFactory = (SessionFactory) sce.getServletContext().getAttribute("sessionFactory");
        if (sessionFactory != null && !sessionFactory.isClosed()) {
            sessionFactory.close();
        }
    }
}

然后在web.xml中注册该监听器：

<listener>
    <listener-class>com.yourpackage.AppContextListener</listener-class>
</listener>

3. 修正Docker Compose部署配置 #

确保MySQL完全启动并就绪后，再启动Tomcat，避免因数据库未就绪导致Hibernate初始化失败，进而触发应用停止与后续线程冲突：

version: '3.8'
services:
  tomcat:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      - db
    restart: on-failure
    environment:
      - CATALINA_OPTS="-Djava.security.egd=file:/dev/./urandom"
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_password
      MYSQL_DATABASE: your_db
    ports:
      - "3306:3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5

添加MySQL的healthcheck配置，保证Tomcat仅在数据库处于健康状态时启动。

4. 调整Hibernate初始化时机 #

避免Hibernate在类加载阶段提前初始化，确保SessionFactory由ServletContextListener控制：

• 移除hibernate.cfg.xml中可能触发提前加载的配置（如<property name="hibernate.hbm2ddl.auto">update</property>），改为在监听器中手动执行SchemaUpdate操作。
• 将SessionFactory绑定到ServletContext，避免静态类持有引用导致内存泄漏。

验证修复 #

1. 重新构建Docker镜像：docker-compose build
2. 启动服务：docker-compose up
3. 查看Tomcat日志，确认无内存泄漏警告，应用正常启动。

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