Hibernate 實體新增字段導致歷史數據為 null 報錯：數據庫層面更新默認值 vs 代碼層面兼容

現象

表新增非空基本類型字段 (如 double)，歷史數據該字段為 NULL，Hibernate 映射基本類型無法接收 null，讀取時報錯。

解決方案對比

推薦策略

1. 首選方案 1：在維護窗口執行 SQL 更新歷史數據並添加默認約束，保證數據庫層面完整性，Hibernate 映射基本類型安全。
2. 過渡期兼容：臨時改用包裝類型 Double，配合 @ColumnDefault，待數據清洗完成後改回基本類型。

避坑指南

• 新增非空列**必須**指定默認值或先更新現有數據，否則 ALTER TABLE 失敗 (歷史行無值)。
• Hibernate hbm2ddl.auto=update 不會自動處理歷史數據默認值。