MyBatis 獲取 MySQL 自增主鍵：useGeneratedKeys 與 selectKey 兩大方案

MyBatis 插入數據後獲取 MySQL 自增主鍵：兩種核心方案完整指南

在 MyBatis 中插入數據後獲取資料庫生成的自增主鍵（ID），是極高頻的實戰需求。本文詳細解析 useGeneratedKeys 與 selectKey 兩大方案的配置、原理、適用場景與避坑指南。

方案一：useGeneratedKeys + keyProperty（推薦，標準 JDBC 方式）

Mapper XML 配置

    INSERT INTO spares(spares_name, spares_type_id, spares_spec)
    VALUES(#{name}, #{typeId}, #{spec})

關鍵屬性解析

• useGeneratedKeys="true"：啟用 JDBC 3.0 Statement.getGeneratedKeys() 機制
• keyProperty="id"：將生成的主鍵值回填到實體對象的 id 屬性
• keyColumn（可選）：指定資料庫主鍵列名，複合主鍵或列名不同時需設定

實體類要求

public class Spares {
    private Long id;           // 必須有 setter
    private String name;
    private Integer typeId;
    private String spec;
    // getter/setter
}

Service 調用與獲取

@Service
public class SparesServiceImpl implements SparesService {
    @Autowired
    private SparesMapper sparesMapper;

    @Override
    public int insert(Spares spares) {
        int count = sparesMapper.insert(spares);
        // 插入後，spares.getId() 即可獲取自增主鍵！
        System.out.println("新增記錄 ID: " + spares.getId());
        return count;
    }
}

執行流程

1. MyBatis 創建 PreparedStatement，設定 Statement.RETURN_GENERATED_KEYS
2. 執行 executeUpdate()
3. 調用 getGeneratedKeys() 獲取 ResultSet
4. 遍歷 ResultSet，將值通過反射設入實體的 keyProperty 屬性

方案二：selectKey 子元素（通用、支援非自增/複雜主鍵）

Mapper XML 配置

    
        SELECT LAST_INSERT_ID()
    
    INSERT INTO person(name, pswd) VALUES(#{name}, #{pswd})

關鍵屬性解析

• keyProperty="id"：回填目標屬性
• resultType="long"：主鍵值類型
• order="AFTER"：插入後執行（MySQL 自增必須 AFTER）
• order="BEFORE"：插入前執行（適用於序列、UUID 等預先生成主鍵）

MySQL 專用函數

• LAST_INSERT_ID()：返回當前連接最後生成的 AUTO_INCREMENT 值，連接級隔離，並發安全
• SELECT @@IDENTITY：同 LAST_INSERT_ID()，但部分場景不同

兩方案深度對比

進階場景與避坑指南

1. 批量插入獲取多個自增 ID

    INSERT INTO spares(name, type_id, spec) VALUES
    
        (#{item.name}, #{item.typeId}, #{item.spec})
    

要求：MyBatis 3.4.0+、MySQL 5.1.35+ 驅動、rewriteBatchedStatements=true 連接參數。

2. 主鍵非 id 或類型非 Long

    
        SELECT REPLACE(UUID(), '-', '')
    
    INSERT INTO orders(order_no, ...) VALUES(#{orderNo}, ...)

3. 常見錯誤與解決

4. Spring Boot 整合配置

# application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/db?useGeneratedKeys=true&rewriteBatchedStatements=true
    driver-class-name: com.mysql.cj.jdbc.Driver

最佳實踐建議

1. MySQL 自增主鍵首選 useGeneratedKeys：標準、高效、可移植
2. 非自增/跨資料庫/複雜主鍵用 selectKey：靈活可控
3. 實體類必須有對應屬性的 setter，否則回填失敗
4. 批量插入場景：驗證驅動版本與連接參數，測試並發正確性
5. 業務代碼勿依賴 ID 連續性：自增 ID 因回滾、重啟會有間隙

掌握這兩大方案的核心差異與適用邊界，能讓你在任何資料庫主鍵生成場景下遊刃有餘，避免「插入成功但拿不到 ID」的低級錯誤。

1. 上一篇文章： MyBatis 多參數傳遞三種方案詳解與最佳實踐
2. 下一篇文章： CentOS 6.5 搭建 JDK + Tomcat + MySQL 生產環境圖文教程

Java 相關知識

Java 基礎培訓（九）：控制台輸入處理與 Scanner 實戰

控制台交互是 Java 入門必備技能。Scanner 類提供

JCA 詳解：Java EE 中最低調卻關鍵的連接器架構規範

JCA 定位 Java EE Connector Archi

Java 大型二進位檔案讀寫實戰：雙精度浮點數序列化與記憶體高效處理

處理數百 MB 的二進位檔案時，一次性讀入記憶體會導致 OO

Java 並發編程：ConcurrentHashMap 原理深度分析

背景 Hashtable 使用單一鎖鎖定整張表，並發性能差。