Java登录系统AWT-EventQueue-0线程空指针异常排查

AI 小北

2026-8-26

问题根因

报错行st = conn.prepareStatement(query);触发NullPointerException的唯一直接原因是**conn对象为null**，不存在其他触发可能：调用null对象的实例方法必然抛出空指针，和SQL语句query本身、PreparedStatement对象st的初始化状态无关。

绝大多数初学者写Swing+JDBC项目遇到这个问题，都是以下三类场景导致conn为null：

数据库连接初始化逻辑执行失败，异常被无意义吞掉：JDBC驱动未导入、数据库地址/账号/密码配置错误、本地数据库服务未启动、目标库不存在等问题都会导致DriverManager.getConnection()执行失败，如果写代码时catch块内没有打印异常、也没有做失败处理，会直接返回null赋值给conn
连接对象作用域错误：把conn定义为类成员变量，但初始化conn的逻辑写在其他类/其他窗口的生命周期方法里，当前注册窗口触发checkUsername方法时，conn从未被赋值
连接提前释放：之前的数据库操作执行完成后提前关闭了conn连接，但没有重新初始化，后续调用checkUsername时使用的是已经被回收的空引用

修复方案

按以下步骤排查修复即可：

先确认conn的空值状态
在报错行前加一行调试代码：

System.out.println("调试-当前conn值：" + conn);

运行触发创建账号操作，控制台如果输出调试-当前conn值：null，即可坐实上述根因判断。

修复数据库连接获取逻辑

确认JDBC驱动正确导入NetBeans项目：MySQL 8.0及以上版本使用驱动类com.mysql.cj.jdbc.Driver，5.x版本使用com.mysql.jdbc.Driver，驱动包要和项目使用的MySQL版本匹配
检查连接配置：核对数据库连接URL、用户名、密码拼写，确认本地MySQL服务处于启动状态，URL中指定的数据库已经创建完成
禁止吞异常：写连接获取逻辑时，catch块必须打印完整异常堆栈，不要留空catch块，方便直接定位连接失败的具体原因
调整连接使用方式：不要把conn定义为全局共享变量反复使用，推荐在每个需要执行SQL的方法内部单独获取连接，SQL执行完成后按顺序关闭ResultSet、PreparedStatement、Connection资源，避免跨方法调用时连接未初始化、提前失效的问题

增加非空校验
在执行prepareStatement调用前增加conn非空判断，避免直接抛出空指针：

if (conn == null) {
    JOptionPane.showMessageDialog(null, "数据库连接失败，请检查服务状态");
    return false;
}

参考实现

调整后的checkUsername方法参考写法：

// 数据库配置常量，统一管理避免拼写错误
private static final String JDBC_URL = "jdbc:mysql://localhost:3306/你的数据库名?useSSL=false&serverTimezone=Asia/Shanghai";
private static final String DB_USER = "你的数据库用户名";
private static final String DB_PASSWORD = "你的数据库密码";

private boolean checkUsername(String inputUsername) {
    Connection localConn = null;
    PreparedStatement localSt = null;
    ResultSet localRs = null;
    try {
        // 加载JDBC驱动
        Class.forName("com.mysql.cj.jdbc.Driver");
        // 方法内部获取独立连接
        localConn = DriverManager.getConnection(JDBC_URL, DB_USER, DB_PASSWORD);
        String checkSql = "SELECT COUNT(*) FROM user_info WHERE username = ?";
        localSt = localConn.prepareStatement(checkSql);
        localSt.setString(1, inputUsername);
        localRs = localSt.executeQuery();
        if (localRs.next()) {
            // 统计数大于0说明用户名已存在
            return localRs.getInt(1) > 0;
        }
        return false;
    } catch (Exception e) {
        // 打印完整异常信息方便排查
        e.printStackTrace();
        JOptionPane.showMessageDialog(null, "用户名校验失败：" + e.getMessage());
        return false;
    } finally {
        // 按顺序关闭资源，避免数据库连接泄漏
        try {
            if (localRs != null) localRs.close();
            if (localSt != null) localSt.close();
            if (localConn != null) localConn.close();
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

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