.NET Maui Android中SQLite数据库复制回设备后启动崩溃求助

问题核心原因 #

通过USB复制回设备的数据库文件，其文件所有者和权限配置和应用自行创建的文件不一致。Android的沙箱权限机制下，即使文件管理器显示非只读状态，应用进程也无法获取足够的读写权限，最终触发SQLite Error 14: unable to open database file错误。

即时修复方法 #

1. 手动修正文件权限 #

在应用启动阶段，检查目标数据库文件的权限并强制赋予读写权限：

var dbPath = Path.Combine(
    Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads).AbsolutePath,
    "your_database.db"
);
var dbFile = new Java.IO.File(dbPath);

if (dbFile.Exists())
{
    // 赋予所有用户读写权限（可根据需求调整为仅应用所有者）
    dbFile.SetReadable(true, false);
    dbFile.SetWritable(true, false);
}

注意：Android 10及以上版本，需要在清单文件中申请MANAGE_EXTERNAL_STORAGE权限，或通过MediaStore API处理公共目录文件。

2. 迁移至应用私有目录 #

将外部复制的数据库文件转移到应用沙箱内的私有目录（权限完全由应用控制）再使用：

var publicDbPath = Path.Combine(
    Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads).AbsolutePath,
    "your_database.db"
);
var privateDbPath = Path.Combine(FileSystem.AppDataDirectory, "your_database.db");

if (File.Exists(publicDbPath) && !File.Exists(privateDbPath))
{
    File.Copy(publicDbPath, privateDbPath);
    // 可选：复制完成后删除公共目录的文件，避免后续混淆
}

// 使用私有目录路径初始化数据库连接
var connection = new SqliteConnection($"Data Source={privateDbPath}");

更佳数据库迁移方案 #

1. 优先使用应用私有目录存储主库 #

应用私有目录（FileSystem.AppDataDirectory）属于沙箱隔离区域，只有当前应用能访问，不会被外部操作干扰，权限稳定，从根源避免权限问题。

2. 实现应用内导入/导出功能 #

完全通过应用逻辑完成数据库备份与恢复，确保文件权限一致性：

导出备份到公共目录

var privateDbPath = Path.Combine(FileSystem.AppDataDirectory, "your_database.db");
var exportPath = Path.Combine(
    Android.OS.Environment.GetExternalStoragePublicDirectory(Android.OS.Environment.DirectoryDownloads).AbsolutePath,
    "db_backup_" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".db"
);

if (File.Exists(privateDbPath))
{
    File.Copy(privateDbPath, exportPath, overwrite: true);
    // 提示用户备份完成
}

从公共目录导入备份

// 让用户选择Downloads目录下的备份文件（可通过FilePicker实现）
var result = await FilePicker.Default.PickAsync(new PickOptions
{
    PickerTitle = "选择数据库备份文件",
    FileTypes = new FilePickerFileType(new Dictionary<DevicePlatform, IEnumerable<string>>
    {
        { DevicePlatform.Android, new[] { "application/vnd.sqlite3" } }
    })
});

if (result != null)
{
    var importPath = result.FullPath;
    var privateDbPath = Path.Combine(FileSystem.AppDataDirectory, "your_database.db");
    File.Copy(importPath, privateDbPath, overwrite: true);
    // 提示用户导入完成
}

3. 避免手动USB操作数据库文件 #

直接通过USB修改应用依赖的数据库文件，很容易破坏文件权限或完整性，尽量通过应用内的导入导出功能完成迁移操作。

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