快捷導(dǎo)航

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

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

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

前言

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

這篇文章我結(jié)合一個小 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 項目里寫了一個最普通的查詢：

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，或者參數(shù)占位符數(shù)量不對。
參數(shù)綁定異常：明明是數(shù)字，結(jié)果 setString()；或者順序錯了。
SQL 沒有打印日志：導(dǎo)致無法復(fù)現(xiàn)真實執(zhí)行的 SQL。

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

遇到 SQLException 時，不要慌，通常從以下幾個角度來排查：

1.打印完整 SQL

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

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

確認每個 ? 是否都被正確賦值，并且類型匹配。

3.用日志記錄 SQL

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

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

我們可以寫一個簡單的工具方法來封裝 SQL 執(zhí)行和日志打印。這樣每次執(zhí)行 SQL 時，都能清晰看到完整的 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);
    }
}

運行效果：