.NET MAUI应用中Path.Combine生成SQLite数据库路径为空问题

问题核心 #

你的代码存在两个关键问题：一是使用了异步void方法导致数据库初始化逻辑无法被等待，可能造成后续调用时连接未就绪；二是Environment.GetFolderPath在MAUI跨平台场景下存在兼容性问题，不如MAUI专属API稳定。

修复方案 #

1. 替换异步void为异步Task #

异步void方法无法被外部等待，会导致初始化流程失控，修改代码如下：

public SQLiteAsyncConnection _dbConnection;

public SqlightServiceClass()
{
    InitializeDatabaseAsync().Wait();
}

// 将async void改为async Task，支持等待逻辑
public async Task InitializeDatabaseAsync()
{
    if (_dbConnection == null)
    {
        // 使用MAUI官方推荐的FileSystem获取稳定路径
        string appDataPath = FileSystem.Current.AppDataDirectory;
        string dbPath = Path.Combine(appDataPath, "Employees.db3");

        _dbConnection = new SQLiteAsyncConnection(dbPath);
        await _dbConnection.CreateTableAsync<ClientInfoModel>();
    }
}

2. 强制使用MAUI专属路径API #

FileSystem.Current.AppDataDirectory是MAUI为跨平台设计的API，能在iOS、Android、Windows等所有目标平台稳定返回应用专属的数据存储目录，完全替代Environment.GetFolderPath的兼容性问题。

3. 验证路径有效性 #

可以添加调试输出确认路径是否生成：

// 获取路径后添加调试打印
Debug.WriteLine($"数据库实际路径：{dbPath}");

如果路径仍为空，检查项目是否正确引用Microsoft.Maui.Storage NuGet包（MAUI项目默认包含，若手动移除需重新添加）。

4. 优化初始化时机（可选） #

更优雅的做法是不在构造函数中处理异步逻辑，改为在应用启动时初始化服务：

// 在MauiProgram.cs的服务注册中处理
builder.Services.AddSingleton<SqlightServiceClass>(sp =>
{
    var service = new SqlightServiceClass();
    service.InitializeDatabaseAsync().Wait();
    return service;
});

关键注意事项 #

• 业务逻辑中禁止使用async void（仅事件处理程序例外），否则会引发未捕获异常和异步流程混乱。
• MAUI跨平台开发优先使用框架提供的专属API，避免依赖.NET Framework旧API的兼容性问题。

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