Java 與 MySQL 數據類型映射對照表：JDBC Type、長度、封裝類完整指南

核心映射表 (MySQL 8.0 / Connector/J 8.0 基準)

關鍵映射決策點

1. TINYINT(1) → Boolean 還是 Integer？

# 連接串參數控制
tinyInt1isBit=true   # 默認 true：TINYINT(1) → Boolean
tinyInt1isBit=false  # TINYINT(1) → Integer (推薦，避免 ORM 映射混淆)

2. 無符號類型處理

• MySQL INT UNSIGNED 範圍 0 ~ 42.9 億，超過 Java Integer.MAX_VALUE (21.4 億)
• 映射策略：
  li>讀取：Long / BigInteger
  • 寫入：應用層校驗範圍，或用 UNSIGNED 列配合 Long

3. 日期時間類型與時區

4. DECIMAL 精確計算

// ❌ 錯誤：Double 精度丟失
double amount = rs.getDouble("price"); 

// ✅ 正確：BigDecimal 精確
BigDecimal amount = rs.getBigDecimal("price"); 

// JPA/Hibernate 映射
@Column(precision = 19, scale = 4)
private BigDecimal price;

5. BLOB 讀寫最佳實踐

// 寫入
try (InputStream is = new FileInputStream(file)) {
    ps.setBinaryStream(1, is, file.length());
    ps.executeUpdate();
}

// 讀取 (大對象分塊)
Blob blob = rs.getBlob("data");
try (InputStream is = blob.getBinaryStream();
     OutputStream os = new FileOutputStream("out")) {
    byte[] buf = new byte[8192];
    int len;
    while ((len = is.read(buf)) > 0) os.write(buf, 0, len);
}

連接串完整參數模板 (Connector/J 8.0+)

jdbc:mysql://localhost:3306/mydb?
useUnicode=true&
characterEncoding=utf8mb4&
serverTimezone=Asia/Shanghai&
tinyInt1isBit=false&
useSSL=false&
allowPublicKeyRetrieval=true&
nullNamePatternMatchesAll=true&
connectionCollation=utf8mb4_general_ci

總結

類型映射不是「照表對照」那麼簡單，**無符號溢出、時區轉換、精度丟失、Boolean 映射、大對象流式處理** 才是生產環境的真實挑戰。建立團隊統一的「類型映射規範文檔」，Code Review 時重點檢查，能消除 90% 的持久層 Bug。