.NET 8下.NET Maui用Dapper连接SQL Server LocalDB的冲突问题

我基于.NET 8开发了一个.NET MAUI应用，使用Dapper连接SQL Server LocalDB数据库：

• 调试应用时可正常读写数据，但此时Visual Studio的SQL Server Object Explorer（SSOE）无法显示服务器及数据库；结束调试后SSOE仍无法恢复，重启Visual Studio也无效，必须用文件解锁工具释放%appdata%\Local\Microsoft\MS SQL Server Local DB\Instances\MSSQLLocalDb路径下的文件才能恢复。
• 反之，先通过SSOE或Azure Data Studio连接数据库，再启动调试应用时，会抛出Microsoft.Data.SqlClient.SqlException（HResult=0x80131904），提示LocalDB实例启动失败；事件查看器显示Windows API错误码575，同样需要解锁文件才能恢复。

Dapper数据访问代码如下：

public IEnumerable<Team> GetTeam()
{
    string sql = @"SELECT * FROM teams Order by name";

    using (IDbConnection db = new SqlConnection(ConnectionString))
    {
        var debugVar = db.Query<Team>(sql).ToList();
        return debugVar;
    }
}

问题自升级到.NET 8后出现，已安装SQL Server Management Studio（SSMS）用于访问LocalDB，寻求解决方案。

1. 优化连接字符串配置 #

LocalDB默认会保持实例运行以提升性能，但可能导致文件被长期锁定。在连接字符串中添加以下参数，强制连接关闭后释放资源：

Server=(localdb)\\MSSQLLocalDB;Database=YourDatabase;Trusted_Connection=True;AutoClose=True;MultipleActiveResultSets=False;

• AutoClose=True：数据库在无连接时自动关闭，释放文件锁
• MultipleActiveResultSets=False：禁用多活动结果集，减少连接占用时间

2. 调试结束后强制停止LocalDB实例 #

在MAUI应用的退出逻辑中，添加命令强制停止LocalDB实例，确保调试进程结束后释放文件锁：
在App.xaml.cs的OnStop方法中添加代码：

protected override void OnStop()
{
    base.OnStop();
    // 强制停止LocalDB实例
    using (var process = new System.Diagnostics.Process())
    {
        process.StartInfo.FileName = "sqllocaldb";
        process.StartInfo.Arguments = "stop MSSQLLocalDB";
        process.StartInfo.CreateNoWindow = true;
        process.StartInfo.UseShellExecute = false;
        process.Start();
        process.WaitForExit();
    }
}

注意：需要添加using System.Diagnostics;引用。

3. 调整Visual Studio调试进程设置 #

确保调试停止后MAUI进程完全退出：

1. 打开Visual Studio，依次点击「工具」→「选项」→「调试」→「常规」
2. 勾选「调试停止时终止所有进程」
3. 取消勾选（如果存在）「调试停止后保持进程活动」

4. 验证.NET 8与LocalDB的兼容性 #

• 升级Microsoft.Data.SqlClient NuGet包到最新稳定版本（当前推荐6.0.1+），或降级到5.1.5版本（此版本与.NET 8兼容性较好）
• 安装最新版SQL Server 2022 LocalDB运行时，确保与.NET 8的适配性：可通过SQL Server Express安装包选择LocalDB组件进行安装

5. 改用永久LocalDB数据库（替代AttachDbFilename方式） #

如果当前使用AttachDbFilename连接数据库，改为创建永久数据库可避免文件独占锁定：

1. 打开SSMS，连接到(localdb)\MSSQLLocalDB实例
2. 新建数据库（例如命名为YourAppDb）
3. 修改连接字符串为：

Server=(localdb)\\MSSQLLocalDB;Database=YourAppDb;Trusted_Connection=True;

这种方式下，LocalDB实例会管理数据库文件，不会被应用进程直接独占锁定。

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