MAUI应用中SQLite数据库路径无法访问及定位问题求助

核心问题分析 #

你遇到的路径错误、数据库未创建问题，主要源于跨平台路径获取方式不准确、异步初始化的执行风险，以及SQLite打开参数的兼容性问题。

分步解决方案 #

1. 替换为MAUI官方推荐的跨平台路径API

放弃Environment.GetFolderPath，改用MAUI封装的FileSystem.AppDataDirectory，它会自动适配各平台的沙盒数据目录，避免路径适配错误：

private const string DbName = "SweetsShopDb.db3";
// 替换路径获取逻辑
private static string DbPath => Path.Combine(FileSystem.AppDataDirectory, DbName);

2. 修正异步初始化的执行方式

async void修饰的OnAppearing存在异常无法捕获、执行顺序不可控的问题，建议改用更可靠的初始化方式：

• 方式一：App启动时全局初始化
  在App.xaml.cs中获取服务并完成初始化：

protected override async void OnStart()
{
    base.OnStart();
    var db = Services.GetRequiredService<SweetsShopDb>();
    await db.Init();
}

• 方式二：页面内安全异步初始化
  若需在页面加载时初始化，避免直接使用async void：

private readonly SweetsShopDb _sweetsShopDb;

public MainPage(SweetsShopDb sweetsShopDb)
{
    InitializeComponent();
    _sweetsShopDb = sweetsShopDb;
    // 用异步任务执行初始化，不阻塞UI
    _ = InitializeDatabaseAsync();
}

private async Task InitializeDatabaseAsync()
{
    await _sweetsShopDb.Init();
}

3. 调整SQLite打开参数

移除SQLiteOpenFlags.SharedCache，该参数在部分平台可能引发权限或兼容性问题，保留基础的创建与读写权限即可：

public async Task Init()
{
    // 先确认目录存在，避免因路径不存在导致创建失败
    var dbDirectory = Path.GetDirectoryName(DbPath);
    if (!Directory.Exists(dbDirectory))
    {
        Directory.CreateDirectory(dbDirectory);
    }

    // 简化打开参数
    Database = new SQLiteAsyncConnection(DbPath, SQLiteOpenFlags.Create | SQLiteOpenFlags.ReadWrite);
    await Database.CreateTableAsync<User>();

    // 可选：打印调试信息验证结果
    Debug.WriteLine($"数据库路径：{DbPath}");
    Debug.WriteLine($"User表是否创建成功：{await Database.TableExistsAsync<User>()}");
}

4. 验证路径与数据库文件

• Android平台：通过设备文件管理器（需调试权限）访问/data/data/com.amr.sweetsshop/files/目录，检查数据库文件是否生成。
• Windows平台：路径应为C:\Users\HP\AppData\Local\Packages\com.amr.sweetsshop_9zz4h110yvjzm\LocalState\，执行初始化后该目录下会出现SweetsShopDb.db3文件。

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