如何在Debug构建配置下实现Room数据库不加密？

核心思路是利用Android构建变体自带的BuildConfig.DEBUG标识，让加密逻辑仅在Release构建下生效，Debug模式下直接明文存储目标字段，无需修改实体类或Room配置结构。具体实现步骤如下：

1. 编写加密工具类，根据构建类型切换逻辑 #

创建AES加密工具类，内部通过BuildConfig.DEBUG判断当前构建模式：Debug下直接返回原字符串，不执行加密解密；Release下执行标准AES加解密逻辑。

object EncryptionUtils {
    // 注意：Release环境请勿硬编码密钥，建议通过Android Keystore系统生成/获取
    private const val AES_KEY = "your_secure_production_key"

    fun encrypt(input: String): String {
        if (BuildConfig.DEBUG) return input
        // Release模式执行AES加密
        return try {
            val keySpec = SecretKeySpec(AES_KEY.toByteArray(), "AES")
            val cipher = Cipher.getInstance("AES/ECB/PKCS5Padding")
            cipher.init(Cipher.ENCRYPT_MODE, keySpec)
            val encryptedBytes = cipher.doFinal(input.toByteArray())
            Base64.encodeToString(encryptedBytes, Base64.DEFAULT)
        } catch (e: Exception) {
            throw RuntimeException("Encryption failed", e)
        }
    }

    fun decrypt(input: String): String {
        if (BuildConfig.DEBUG) return input
        // Release模式执行AES解密
        return try {
            val keySpec = SecretKeySpec(AES_KEY.toByteArray(), "AES")
            val cipher = Cipher.getInstance("AES/ECB/PKCS5Padding")
            cipher.init(Cipher.DECRYPT_MODE, keySpec)
            val decodedBytes = Base64.decode(input, Base64.DEFAULT)
            String(cipher.doFinal(decodedBytes))
        } catch (e: Exception) {
            throw RuntimeException("Decryption failed", e)
        }
    }
}

2. 编写Room类型转换器 #

创建Room的TypeConverter类，调用加密工具类的方法，实现字符串与加密字符串的自动转换：

class StringEncryptionConverter {
    @TypeConverter
    fun encryptString(value: String?): String? {
        return value?.let { EncryptionUtils.encrypt(it) }
    }

    @TypeConverter
    fun decryptString(value: String?): String? {
        return value?.let { EncryptionUtils.decrypt(it) }
    }
}

3. 在实体类中应用转换器 #

在包含目标字段的实体类上，通过@TypeConverters注解指定使用上述转换器，让Room自动处理名字、姓氏的加密存储与解密读取：

@Entity(tableName = "users")
@TypeConverters(StringEncryptionConverter::class)
data class User(
    @PrimaryKey val id: Int,
    val firstName: String, // Debug明文存储，Release加密存储
    val lastName: String,  // Debug明文存储，Release加密存储
    val phone: String      // 示例：无需加密的字段
)

关键注意事项 #

• 密钥安全：Release环境必须使用Android Keystore管理密钥，绝对禁止硬编码密钥，避免逆向破解泄露。
• 构建验证：BuildConfig.DEBUG由Android Gradle插件自动生成，Debug构建下默认值为true，无需手动修改。
• 调试便利：Debug模式下直接明文存储，可通过Database Inspector直接查看字段内容，大幅提升调试效率。

内容的提问来源于stack exchange，提问作者Денис