Java EE CheckboxList 回顯異常：MySQL 語句手誤導致數據綁定失敗

問題現象

Struts2 / Spring MVC 頁面中 `` / `` 回顯時，勾選狀態與數據庫實際值不一致，甚至全部未勾選或報錯。

根因排查

經檢查 DAO 層 SQL 語句，**手誤將 `IN` 寫成 `=` 或列表拼接缺少引號**，導致查詢返回結果集為空或錯誤，進而綁定失敗。
典型錯誤：

-- ❌ 錯誤：單值比較
SELECT * FROM role WHERE id = '1,2,3'

-- ✅ 正確：集合比較
SELECT * FROM role WHERE id IN (1,2,3)
-- 或參數化 (MyBatis)
SELECT * FROM role WHERE id IN

    #{id}

修正後驗證

1. 在資料庫客戶端直接執行修正後 SQL，確認返回預期行數
2. 單元測試 DAO 方法：`assertEquals(expectedIds, dao.getRoleIds(userId))`
3. 重新啟動應用，頁面回顯恢復正常

最佳實踐：避免手寫 SQL 拼接

• 使用 **MyBatis ``** / **JPA `IN :ids`** / **Dapper `@ids`** 參數化集合綁定
• 啟用 SQL 日誌 (Log4jdbc, P6Spy, Hibernate `show_sql=true`) 開發期自動輸出實際執行語句
• Code Review 重點檢查 `IN` / `NOT IN` 子句參數傳遞

CheckboxList 綁定核心邏輯 (Struts2 為例)

// Action
private List roleIds; // 必須與 name="user.roleIds" 對應
// getter/setter
// 回顯時：roleIds = roleService.getIdsByUserId(userId); // 返回 List {1,3}

框架會自動將 `roleIds` 中的值與 `allRoles` 的 `listKey` 比對，**類型必須一致** (Integer vs Integer, String vs String)，否則勾選失效。

總結

**90% 回顯異常源於 SQL 錯誤或類型不匹配**而非框架 Bug。修正 SQL、統一類型、加上單元測試，問題即刻消失。