快捷導(dǎo)航

java.sql.SQLException異常原因排查與解決

更新時(shí)間：2025年09月29日 09:28:04 作者：網(wǎng)羅開發(fā)

在日常開發(fā)中,大家應(yīng)該或多或少都遇到SQL 在本地跑得好好的,一放到服務(wù)里執(zhí)行就報(bào) java.sql.SQLException,本文將結(jié)合一個(gè)小 Demo,帶大家看一下 SQLException 的常見原因,以及如何一步步排查

前言

在日常開發(fā)中，大家應(yīng)該或多或少都遇到過這種情況：SQL 在本地跑得好好的，一放到服務(wù)里執(zhí)行就報(bào) java.sql.SQLException。很多同學(xué)看到這個(gè)異常時(shí)，第一反應(yīng)就是“是不是數(shù)據(jù)庫掛了？”。其實(shí)絕大多數(shù)情況跟數(shù)據(jù)庫無關(guān)，而是 SQL 拼接、參數(shù)綁定或者日志缺失導(dǎo)致的。

這篇文章我結(jié)合一個(gè)小 Demo，帶大家看一下 SQLException 的常見原因，以及如何一步步排查。

場景描述：常見的 SQLException 問題

假設(shè)我們有一張 users 表，結(jié)構(gòu)很簡單：

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

在 Java 項(xiàng)目里寫了一個(gè)最普通的查詢：

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();

看似沒問題，但在真實(shí)項(xiàng)目里，很容易因?yàn)橄旅鎺讉€(gè)問題報(bào) SQLException：

SQL 拼接錯(cuò)誤：比如忘了 AND，或者參數(shù)占位符數(shù)量不對。
參數(shù)綁定異常：明明是數(shù)字，結(jié)果 setString()；或者順序錯(cuò)了。
SQL 沒有打印日志：導(dǎo)致無法復(fù)現(xiàn)真實(shí)執(zhí)行的 SQL。

排查思路：怎么快速鎖定問題？

遇到 SQLException 時(shí)，不要慌，通常從以下幾個(gè)角度來排查：

1.打印完整 SQL

很多時(shí)候，你以為你執(zhí)行的是 SELECT * FROM users WHERE username = 'zhangfei'，實(shí)際上可能變成了 SELECT * FROM users WHERE username = 'null'。

2.檢查參數(shù)綁定

確認(rèn)每個(gè) ? 是否都被正確賦值，并且類型匹配。

3.用日志記錄 SQL

不僅要打印原始 SQL，還要把 參數(shù)替換后的 SQL 打出來，方便直接拿去數(shù)據(jù)庫執(zhí)行。

Demo：帶日志的 SQL 執(zhí)行封裝

我們可以寫一個(gè)簡單的工具方法來封裝 SQL 執(zhí)行和日志打印。這樣每次執(zhí)行 SQL 時(shí)，都能清晰看到完整的 SQL。

import java.sql.*;
import java.util.Arrays;

public class JdbcHelper {

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

            // 參數(shù)綁定
            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 執(zhí)行異常: " + e.getMessage());
            e.printStackTrace();
        }
    }

    // 將參數(shù)替換到 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);
    }
}

運(yùn)行效果：