在項目中，為了保證數據安全，我們可能會對 SQLite 數據庫進行加密（例如使用 SQLiteMC/SQLCipher）。然而，加密數據庫在帶來安全性的同時，也會帶來顯著的性能損耗。本文結合實測與源碼分析，介紹 SQLite 加密與不加密的性能差異，并給出參數優化建議。

---

1. 加密與不加密的性能差異

• 普通 SQLite：

  • 數據庫是明文文件，所有讀寫操作直接進行磁盤 IO。

  • 性能接近原生文件系統，單機場景下插入/查詢都非常快。

• 加密 SQLite (SQLCipher/SQLiteMC)：

  • 每個數據庫頁都需要 加解密。

  • 連接時需要進行 KDF（密鑰派生函數）迭代計算。

  • 在默認配置下，性能可能比普通 SQLite 慢 5~10 倍。

也就是說，如果你發現數據庫加密后性能急劇下降，這是正常現象，而不是你代碼有問題。

---

2. 加密參數詳解

SQLiteMC 提供了一系列配置項，可以調節安全性與性能之間的平衡。

(1) kdfIter — KDF 迭代次數

• 作用：在打開數據庫時，把明文密碼轉換為實際密鑰。

• 影響：數值越大，破解難度越高，但每次連接都需要更多 CPU 計算。

• 默認值：256000（非常耗時）。

• 優化建議：64k ~ 16k；在受控環境下甚至可降到 4k。

---

(2) pageSize — 數據庫頁大小

• 作用：SQLite 以“頁”為單位讀寫，每一頁都需要加解密。

• 影響：頁越大，讀寫時需要解密的次數越少，但每次操作的粒度更粗。

• 默認值：4096。

• 優化建議：8192（寫多讀少時可用 16384）。

---

(3) HmacAlgorithm & KdfAlgorithm — 哈希算法

• 作用：保證數據完整性、密鑰派生。

• 常見取值：SHA512（默認）、SHA256、SHA1。

• 影響：SHA512 最安全但最慢，SHA256 性能提升 30%+，SHA1 更快但安全性較低。

• 優化建議：SHA256（安全和性能的平衡點）。

---

(4) withKey — 數據庫密鑰

• 設置數據庫密碼。

• 需要在所有連接初始化時傳入，否則無法訪問數據庫。

---

3. 推薦的最優性能配置

如果你對性能有較高要求，同時需要一定的安全性，可以使用如下配置：

SQLiteMCSqlCipherConfig cipherConfig = new SQLiteMCSqlCipherConfig() .getDefault() .getV4Defaults(); // 頁大小：8192（比默認 4k 更快） cipherConfig.setLegacyPageSize(8192); // KDF 迭代次數：16000（安全性與性能的折中） cipherConfig.setKdfIter(16000); // 使用 SHA256 替代 SHA512，性能更好 cipherConfig.setHmacAlgorithm(HmacAlgorithm.SHA256); cipherConfig.setKdfAlgorithm(KdfAlgorithm.SHA256); // 設置數據庫密鑰 cipherConfig.withKey("MySecurePassword!");

📊 預期性能對比

配置	插入 10 萬條	查詢 10 萬條	相對性能
普通 SQLite	~1s	~0.8s	100%
默認加密 (256k+SHA512+4k)	~12s	~9s	10-15%
優化版 (64k+SHA256+8k)	~3s	~2.5s	30-40%
激進版 (16k+SHA256+16k)	~1.8s	~1.5s	50-60%

?? 注意：不同硬件和數據規模下會有差異，但趨勢基本一致。

加密依賴

<dependency><groupId>io.github.willena</groupId><artifactId>sqlite-jdbc</artifactId><version>3.49.1.0</version>
</dependency>

不加密依賴

<dependency><groupId>org.xerial</groupId><artifactId>sqlite-jdbc</artifactId><version>3.47.0.0</version>
</dependency>