JSP 中獲取 MSSQL 自增主鍵值的最佳實踐：存儲過程與 JDBC 3.0 標準方案

問題背景

在 MSSQL 中，採用 IDENTITY(1,1) 定義的自增主鍵列，插入新記錄後，應用層往往需要立即獲取該記錄的主鍵值（如用於關聯插入子表、返回前端展示、日誌追蹤）。傳統做法查詢 @@IDENTITY 或 SCOPE_IDENTITY() 存在併發風險與連接狀態依賴，本文對比多種方案，推薦 JDBC 3.0 標準 getGeneratedKeys() 為首選。

方案對比與風險分析

推薦方案：JDBC 3.0 標準 API 實現

單條插入獲取主鍵

String sql = "INSERT INTO student (username) VALUES (?)";
try (Connection conn = dataSource.getConnection();
     PreparedStatement pstmt = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) {
    
    pstmt.setString(1, "張三");
    int affected = pstmt.executeUpdate();
    
    if (affected > 0) {
        try (ResultSet rs = pstmt.getGeneratedKeys()) {
            if (rs.next()) {
                int generatedId = rs.getInt(1); // 或 getLong(1)
                System.out.println("新記錄 ID：" + generatedId);
            }
        }
    }
}

批量插入獲取多個主鍵

String sql = "INSERT INTO student (username) VALUES (?)";
try (Connection conn = dataSource.getConnection();
     PreparedStatement pstmt = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) {
    
    List<String> names = Arrays.asList("李四", "王五", "趙六");
    for (String name : names) {
        pstmt.setString(1, name);
        pstmt.addBatch();
    }
    int[] results = pstmt.executeBatch();
    
    try (ResultSet rs = pstmt.getGeneratedKeys()) {
        int idx = 0;
        while (rs.next() && idx < results.length) {
            if (results[idx] == Statement.SUCCESS_NO_INFO || results[idx] > 0) {
                System.out.println(names.get(idx) + " -> ID: " + rs.getLong(1));
            }
            idx++;
        }
    }
}

MSSQL 驅動配置關鍵點

• 驅動版本：使用 Microsoft 官方驅動 mssql-jdbc 9.4+ (JDBC 4.2/4.3)，Maven 坐標：com.microsoft.sqlserver:mssql-jdbc。
• 連接字串：建議添加 sendStringParametersAsUnicode=false 提升效能，trustServerCertificate=true 開發環境跳過 SSL 驗證。
• 表結構要求：自增列必須定義為 IDENTITY(1,1) 且為主鍵或唯一索引列。

存儲過程方案完整代碼（兼容舊系統）

若受限於歷史架構必須使用存儲過程，正確寫法如下：

MSSQL 存儲過程

CREATE PROCEDURE usp_InsertStudent
    @Username NVARCHAR(50),
    @NewID INT OUTPUT
AS
BEGIN
    SET NOCOUNT ON;
    INSERT INTO student (username) VALUES (@Username);
    SET @NewID = SCOPE_IDENTITY(); -- 必須用 SCOPE_IDENTITY()
END

JSP/Java 調用代碼

<%
    String url = "jdbc:sqlserver://localhost:1433;databaseName=school;sendStringParametersAsUnicode=false";
    String user = "sa"; String pwd = "your_password";
    
    try (Connection conn = DriverManager.getConnection(url, user, pwd);
         CallableStatement cstmt = conn.prepareCall("{call usp_InsertStudent(?, ?)}")) {
        
        cstmt.setString(1, "孫七");
        cstmt.registerOutParameter(2, java.sql.Types.INTEGER);
        cstmt.execute();
        
        int newId = cstmt.getInt(2);
        out.println("插入成功，自增 ID：" + newId);
    } catch (SQLException e) {
        e.printStackTrace();
        out.println("錯誤：" + e.getMessage());
    }
%>

常見陷阱與排查清單

1. 使用 Statement.NO_GENERATED_KEYS 或預設值：必須顯式傳入 Statement.RETURN_GENERATED_KEYS。
2. 獲取 ResultSet 後未調用 next()：游標初始在第一行之前，必須先 next() 再 getInt()。
3. 連接池自動提交導致事務邊界模糊：批量業務建議關閉自動提交 conn.setAutoCommit(false)，手動控制事務。
4. 驅動版本過舊：早期 jTDS 驅動對 getGeneratedKeys 支援不完整，請遷移至官方驅動。
5. 觸發器干擾：若表上有觸發器插入其他自增表，@@IDENTITY 會返回觸發器產生的值，絕對不要使用@@IDENTITY。