MyBatis 動態 SQL 中 IN 條件大量參數導致 SQL 異常長：參數綁定與優化方案

問題現象

日誌顯示生成 SQL 含幾十個 OR id = ? 條件：

SELECT * FROM hd_memory_address where id = ? OR id = ? OR id = ? ... (重複 60+ 次)

導致 SQL 解析緩慢、超過數據庫最大 SQL 長度限制、參數綁定錯誤。

根因分析

• Mapper XML 使用 where id = #{id} 但傳入 List<Integer>，MyBatis 將列表展開為多個 OR 條件
• parameterType="int" 與實際傳入 List 不匹配，導致類型轉換異常
• 未使用 <foreach> 標籤正確構建 IN 子句

正確寫法：使用 <foreach> 構建 IN 條件

Mapper XML

<select id="selectByIds" resultType="MemoryAddress">
  SELECT * FROM hd_memory_address
  <where>
    id IN
    <foreach collection="list" item="id" open="(" separator="," close=")">
      #{id}
    </foreach>
  </where>
</select>

Mapper 接口

List<MemoryAddress> selectByIds(@Param("list") List<Integer> ids);

生成 SQL 效果

SELECT * FROM hd_memory_address WHERE id IN (?, ?, ?, ...)  -- 單個 IN 子句，參數扁平化

進階優化策略

1. 批量操作分頁

單次 IN 參數建議 不超過 1000 個（Oracle 限制 1000，MySQL/PostgreSQL 無硬性限制但性能下降）。大量 ID 分批處理：

public List<MemoryAddress> selectByIdsBatch(List<Integer> ids) {
    List<MemoryAddress> result = new ArrayList<>();
    for (int i = 0; i < ids.size(); i += 1000) {
        List<Integer> batch = ids.subList(i, Math.min(i + 1000, ids.size()));
        result.addAll(mapper.selectByIds(batch));
    }
    return result;
}

2. 臨時表/表值參數

超大批次（萬級以上）建議：

• MySQL：CREATE TEMPORARY TABLE tmp_ids (id INT PRIMARY KEY) 批量插入 ID，再 JOIN 查詢
• SQL Server：使用 Table-Valued Parameter 傳遞 ID 表
• PostgreSQL：unnest(ARRAY[...]) 配合 ANY

3. 參數類型修正

原問題中 parameterType="int" 應改為 java.util.List 或移除（MyBatis 自動推斷）。#{id} vs #id#：前者預編譯參數化（防注入），後者字符串替換（極度不推薦）。

調試技巧

• 開啟 MyBatis 日誌 logging.level.org.apache.ibatis=DEBUG 查看實際 SQL 與參數
• 使用 Explain 分析 IN 子句執行計劃，確認索引命中
• 對比 IN vs JOIN 臨時表 在實際數據量下的性能