动态Web项目JDBC连接MySQL返回null，同代码在Swing项目正常运行

相同JDBC代码在Swing项目正常运行、动态Web项目获取连接返回null，核心原因基本集中在Web项目类加载机制差异、驱动部署错误、代码逻辑遗漏三类，按以下步骤逐一排查即可解决：

1. 修正现有代码的逻辑漏洞 #

你当前的代码存在三个明显问题，会直接导致连接获取失败：

• 驱动加载方法loadDriver是实例方法，静态方法getConnection()执行前从未主动调用过驱动加载逻辑，Web容器的类加载隔离机制会导致JDBC SPI自动扫描驱动失效，根本不会注册MySQL驱动
• 异常捕获后仅打印栈轨迹，没有中断流程，驱动加载失败、SQL异常发生时很容易忽略控制台报错，最后拿到null返回值
• 不建议将Connection定义为静态全局变量，Web项目多线程并发场景下共享单个连接实例会出现线程安全、连接超时释放等问题

修正后的可运行代码如下：

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class RegisterDao {
    // MySQL 5.x版本用这个驱动类名
    public static final String DRIVER_CLASSNAME = "com.mysql.jdbc.Driver";
    // MySQL 8.0+版本请替换为下面的驱动类名
    // public static final String DRIVER_CLASSNAME = "com.mysql.cj.jdbc.Driver";
    // MySQL8.0+版本URL需要追加参数：jdbc:mysql://localhost:3306/userdb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
    public static final String URL = "jdbc:mysql://localhost:3306/userdb";
    public static final String USERNAME = "root";
    public static final String PASSWORD = "";

    // 类加载时就执行驱动注册，不用手动调用实例方法
    static {
        try {
            Class.forName(DRIVER_CLASSNAME);
        } catch (ClassNotFoundException e) {
            // 驱动加载失败直接抛出异常，不要静默忽略
            throw new RuntimeException("MySQL JDBC驱动加载失败，请检查驱动包是否正确部署", e);
        }
    }

    public static Connection getConnection() {
        Connection con = null;
        try {
            con = DriverManager.getConnection(URL, USERNAME, PASSWORD);
        } catch (SQLException e) {
            // 连接获取失败抛出异常，方便定位具体错误原因
            throw new RuntimeException("数据库连接获取失败", e);
        }
        return con;
    }
}

2. 正确部署JDBC驱动包（最常见的根因） #

Swing是JavaSE应用，只要把MySQL驱动包加到项目编译路径就能被应用类加载器扫描到，但动态Web项目由Tomcat/Jetty等Web容器负责类加载，驱动包放错位置必然导致运行时找不到类：

• 普通动态Web项目：将对应版本的mysql-connector-java驱动jar包放到WebContent/WEB-INF/lib目录下，不要只在Build Path中添加依赖，否则部署时不会将驱动包同步到容器运行环境
• Maven管理的Web项目：在pom.xml中引入MySQL驱动依赖，设置scope为runtime，打包时会自动将驱动包输出到WEB-INF/lib目录
• 如果需要容器全局共享驱动，直接将驱动jar包放到Tomcat根目录的lib文件夹下即可

3. 剩余场景排查 #

如果以上两步做完还是无法获取连接，对照以下场景逐一核对：

• 检查MySQL服务状态：确认本地3306端口正常监听、MySQL服务未关闭，如果Web项目部署在Docker容器或远程服务器上，URL中的localhost指向的是容器/远程服务器本身，需要替换为MySQL服务所在机器的实际IP
• 检查账号权限：确认root账号密码配置正确、拥有userdb库的访问权限，MySQL默认root账号很多场景下不允许非本机进程访问
• 检查控制台异常栈：不要忽略异常打印信息，ClassNotFoundException对应驱动部署错误，Access denied for user对应账号密码/权限问题，Communications link failure对应网络不通、服务未启动或URL配置错误

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