java.sql.SQLException异常原因排查与解决_开发_开发者

前言

在日常开发中，大家应该或多或少都遇到过这种情况：SQL 在本地跑得好好的，一放到服务里执行就报 Java.sql.SQLException。很多同学看到这个异常时，第一反应就是“是不是数据库挂了？”。其实绝大多数情况跟数据库无关，而是 SQL 拼接、参数绑定或者日志缺失导致的。

这篇文章我结合一个小 Demo，带大家看一下 SQLException 的常见原因，以及如何一步步排查。

场景描述：常见的 SQLException 问题

假设我们有一张 users 表，结构很简单：

CREATE TABLE users (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    username VARCHAR(50) NOT NULL,
    age INT
);

在 Java 项目里写了一个最普通的查询：

String sql = "SELECT * FROM users WHERE username = ? AND age = ?";
PreparedStatement ps = connection.prepareStatement(sql);
ps.setString(1, "zhangfei");
ps.setInt(2, 18);

ResultSet rs = ps.executeQuery();

看似没问题，但在真实项目里，很容易因为下面几个问题报 SQLException：

SQL 拼接错误：比如忘了 AND，或者参数占位符数量不对。
参数绑定异常：明明是数字，结果 setString()；或者顺序错了。
SQL 没有打印日志：导致无法复现真实执行的 SQL。

排查思路：怎么快速锁定问题？

遇到 SQLException 时，不要慌，通常从以下几个角度来排查：

1.打印完整 SQL

很多时候，你以为你执行的是 SELECT * FROM users WHERE username = 'zhangfei'，实际上可能变成了 SELEjsCT * FROM users WHERE username = 'null'。

2.检查参数绑定

确认每个 ? 是否都被正确赋值，并且类型匹配。

3.用日志记录 SQL

不仅要打印原始 SQL，还要把 参数替换后的 SQL 打出来，方便直接拿去数据库执行。

Demo：带日志的 SQL 执行封装

我们可以写一个简单的工具方法来封装 SQL 执行和日志打印。这样每次执行 SQL 时，都能清晰看到完整的 SQL。

import java.sql.*;
import java.jsutil.Arrays;

public class JdbcHelper {

    public static void executeQuery(Connection conn, String sql, Object... params) {
        try (PreparedStatement ps = conn.prepareStatement(sql)) {

    HAExTyEgbS        // 参数绑定
            for (int i = 0; i < params.编程客栈length; i++) {
                ps.setObject(i + 1, params[i]);
            }

            // 打印完整 SQL
            System.out.println("Executing SQL: " + buildFullSql(sql, params));

            try (编程客栈ResultSet rs = ps.executeQuery()) {
                while (rs.next()) {
                    System.out.println("User: " + rs.getString("username") + ", Age: " + rs.getInt("age"));
                }
            }

        } catch (SQLException e) {
            System.err.println("SQL 执行异常: " + e.getMessage());
            e.printStackTrace();
        }
    }

    // 将参数替换到 SQL 中（简易版）
    private static String buildFullSql(String sql, Object... params) {
        String fullSql = sql;
        for (Object param : params) {
            String value = (param instanceof String) ? "'" + param + "'" : String.valueOf(param);
            fullSql = fullSql.replaceFirst("\\?", value);
        }
        return fullSql;
    }

    // Demo 入口
    public static void main(String[] args) throws Exception {
        Connection conn = DriverManager.getConnection(
                "jdbc:mysql://localhost:3306/testdb", "root", "password");

        executeQuery(conn, "SELECT * FROM users WHERE username = ? AND age = ?", "zhangfei", 18);
    }
}

运行效果：