如何在Xamarin Forms中为SQLite文件添加密码？

你遇到的问题其实很常见——官方的Microsoft.EntityFrameworkCore.Sqlite本身并不直接支持数据库加密，因为默认的SQLite库没有内置加密模块。不过我们可以通过SQLCipher（一个支持加密的SQLite分支）配合EF Core来实现密码保护，下面是针对Xamarin Forms平台的完整可行方案：

步骤1：安装必要的NuGet包 #

首先要替换默认的SQLite实现为带加密功能的版本，同时保留EF Core的相关包：

• 安装SQLitePCLRaw.bundle_sqlcipher：这个包包含了各个平台（iOS/Android/UWP）的SQLCipher原生库，会自动覆盖默认的SQLitePCLRaw提供程序。
• 确保已安装Microsoft.EntityFrameworkCore.Sqlite和Microsoft.EntityFrameworkCore.Tools（用于迁移等操作）。

步骤2：配置带密码的连接字符串 #

在你的DbContext类中，修改OnConfiguring方法，在连接字符串中加入Password参数：

using Microsoft.EntityFrameworkCore;
using System.IO;
using Xamarin.Essentials;

public class AppDbContext : DbContext
{
    // 你的实体集
    public DbSet<YourEntity> YourEntities { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 获取数据库文件的本地路径（Xamarin Forms通用路径）
        string dbPath = Path.Combine(FileSystem.AppDataDirectory, "YourDatabase.db");
        
        // 从安全存储获取密码（不要硬编码！）
        string dbPassword = SecureStorage.GetAsync("DbPassword").Result;
        if (string.IsNullOrEmpty(dbPassword))
        {
            // 首次运行时生成或让用户设置安全密码
            dbPassword = GenerateSecurePassword();
            SecureStorage.SetAsync("DbPassword", dbPassword).Wait();
        }

        // 配置带密码的SQLite连接
        optionsBuilder.UseSqlite($"Data Source={dbPath};Password={dbPassword}");
    }

    // 辅助方法：生成安全随机密码
    private string GenerateSecurePassword()
    {
        return Guid.NewGuid().ToString("N"); // 简单示例，实际可使用更复杂的生成逻辑
    }
}

关键注意点： #

• 首次创建数据库：当EF Core首次创建数据库时，会使用这个密码对数据库进行加密。之后所有连接都必须提供相同的密码，否则无法打开数据库。
• 密码存储：绝对不要硬编码密码！使用Xamarin Essentials的SecureStorage来安全存储密码，它会在各个平台上使用系统级的安全存储（比如iOS的Keychain、Android的Keystore）。

步骤3：加密现有未加密数据库 #

如果你已经有一个未加密的数据库，需要先将它加密才能用密码连接。可以通过SQLCipher的底层API来完成：

using SQLitePCLRaw.core;

public void EncryptExistingDatabase(string oldDbPath, string newDbPath, string password)
{
    // 初始化SQLCipher
    SQLite3.Initialize();

    // 打开未加密的数据库
    using (var oldDb = new SQLiteConnection(oldDbPath))
    {
        oldDb.Open();
        
        // 附加一个新的加密数据库，然后导出数据
        oldDb.Execute($"ATTACH DATABASE '{newDbPath}' AS encrypted KEY '{password}';");
        oldDb.Execute("SELECT sqlcipher_export('encrypted');");
        oldDb.Execute("DETACH DATABASE encrypted;");
    }

    // 之后可以替换原数据库文件（记得备份！）
    File.Delete(oldDbPath);
    File.Move(newDbPath, oldDbPath);
}

调用这个方法前，记得先关闭所有数据库连接，并且做好数据备份！

常见问题排查 #

• 无法打开数据库：检查密码是否正确，或者数据库是否已经加密。如果是首次创建数据库后无法打开，可能是密码存储逻辑出了问题。
• 平台兼容性：SQLitePCLRaw.bundle_sqlcipher已经处理了各平台的原生库，不需要额外配置，但要确保你的Xamarin Forms项目目标框架版本符合包的要求。
• 迁移问题：EF Core的迁移操作不受加密影响，只要连接字符串正确，迁移会正常执行。

内容的提问来源于stack exchange，提问作者Ahmed Shamel