MySQL BLOB vs CLOB 存儲大文件實戰：Spring+Hibernate 配置與文本/二進制選型避坑

核心區別

實戰踩坑：文本文件下載亂碼/換行丟失

現象：用 ClobStringType 存儲文本文件，上傳正常，但下載後**換行符消失、特殊字符變亂碼**。

原因：ClobStringType 將文件讀為 String，經過字符集編解碼 (如 UTF-8)，若文件編碼不一致或含二進制字符，會被替換/截斷。**CLOB 適合「純文本內容」，不適合「文件原樣存取」**。

正確選型決策

IF 文件需原樣下載 (圖片、PDF、Word、壓縮包、加密文件、任意二進制):
    USE BLOB + byte[] / Blob
ELIF 純文本內容需全文搜索、字符級處理 (日誌、文章、代碼、配置):
    USE CLOB + String / Clob
ELSE:
    USE BLOB  -- 兜底最安全

Spring + Hibernate 配置模板

實體類映射 (JPA/Hibernate 5+)

@Entity
@Table(name = "document")
public class Document {
    @Id @GeneratedValue
    private Long id;

    @Lob
    @Basic(fetch = FetchType.LAZY)  -- 關鍵：大對象延遲加載，避免查詢列表時全載入
    @Column(name = "content", columnDefinition = "LONGBLOB")
    private byte[] content;  // BLOB 用 byte[]

    // CLOB 版本
    // @Lob
    // @Basic(fetch = FetchType.LAZY)
    // @Column(name = "content", columnDefinition = "LONGTEXT")
    // private String content;  // CLOB 用 String

    // getters/setters
}

Spring XML 配置 (舊項目)

Repository 存取示例

@Repository
public interface DocumentRepository extends JpaRepository {
    // 查詢列表時不加載 content (得益於 LAZY)
    List findByCategory(String category);

    // 單獨加載 content
    @Lock(LockModeType.PESSIMISTIC_READ)
    @QueryHints({@QueryHint(name = "org.hibernate.fetchProfile", value = "WITH_CONTENT")})
    Optional findWithContentById(Long id);
}

大文件存儲最佳實踐

1. 分塊上傳 + 對象存儲 (OSS/S3/MinIO)：超過 10MB 文件**強烈建議**存對象存儲，DB 只存 URL + 元數據。MySQL BLOB 讀寫佔用連接、緩存、Binlog，高併發下拖垮整庫。
2. 若必須存 DB：
   • 表拆分：document_meta (id, name, size, path) + document_content (id, chunk_index, data BLOB) 分塊存儲，單塊 ≤ 4MB。
   • 讀寫分離：寫入主庫，讀取從庫 (需 log_slave_updates)。
   • 流式讀寫：用 InputStream/OutputStream 避免 JVM OOM，Hibernate Blob.getBinaryStream() 支援流式。
3. Binlog 影響：大 BLOB 寫入產生巨大 Binlog，導致主從延遲、磁盤爆滿。設置 binlog_format=ROW、max_allowed_packet=1G、定期清理 Binlog。
4. 備份策略：邏輯備份 mysqldump 極慢，改用物理備份 xtrabackup 或快照備份。

避坑清單

1. ❌ 用 ClobStringType 存二進制文件 → 下載損壞。
2. ❌ @Lob 不加 @Basic(fetch=LAZY) → 列表查詢全量加載大字段，OOM。
3. ❌ columnDefinition="BLOB" 未指定 LONGBLOB → 默認 64KB 截斷。
4. ❌ 事務中大 BLOB 讀寫未及時提交 → 連接佔用、鎖競爭。
5. ✅ 文件類型判斷：Files.probeContentType(path) 或魔數檢測，決定 BLOB/CLOB。
6. ✅ 單元測試驗證：上傳 → 下載 → MessageDigest.isEqual(originalBytes, downloadedBytes) 校驗 MD5/SHA256 一致。

總結：**BLOB 存文件，CLOB 存文本**。Spring/Hibernate 配置關鍵在 @Basic(fetch=LAZY) + 正確類型映射。生產環境**大文件上對象存儲**，DB 只存元數據，才是架構正解。