Android Room集成SQLCipher后数据库文件无数据问题求助

核心排查与解决步骤 #

1. 下载完整的数据库文件组 #

Room默认启用WAL（预写日志）模式，数据会分散在3个关联文件中：

• 你的数据库名.db（主数据文件）
• 你的数据库名.db-shm（共享内存文件）
• 你的数据库名.db-wal（预写日志文件）

仅下载主.db文件会导致DB Browser无法读取未同步的变更，解决方法：

• 先强制将WAL日志同步到主文件：

  neDatabase.openHelper.writableDatabase.use { db ->
      db.execSQL("PRAGMA wal_checkpoint(FULL);")
  }
  

• 关闭Room数据库实例：

  neDatabase.close()
  

• 从Android Studio的Device File Explorer中，进入data/data/你的包名/databases/目录，下载上述3个文件到本地。

2. 正确配置DB Browser的解密参数 #

SQLCipher的密钥必须和代码逻辑完全匹配才能解密：

• 打开DB Browser并选择Open Database，选中下载的.db文件；
• 在密码弹窗中，选择SQLCipher作为加密类型；
• 直接输入代码中AppConstants.DB_KEY的原始字符串（不要输入字节数组）；
• 如果仍无法打开，勾选Raw key (32 bytes hex)，将代码中passphrase字节数组转成十六进制字符串输入（生成方式：passphrase.joinToString("") { "%02x".format(it) }）。

3. 确保数据库连接已完全释放 #

如果App仍持有数据库连接，Android会锁定文件，导致下载的文件不完整：

• 下载前确保所有Room DAO的操作已完成，调用neDatabase.close()关闭实例；
• 可重启App后再下载，确保连接彻底释放。

4. 验证App内数据确实存在 #

先确认数据已正确写入数据库：

// 示例：查询某表的记录数验证
val recordCount = neDatabase.yourDao().getTotalRecords()
Log.d("DB_VERIFY", "当前记录数：$recordCount")

如果记录数为0，需排查Room的插入逻辑，而非加密或下载环节的问题。

内容的提问来源于stack exchange，提问作者RAGHUL R