升级 VS2022 17.13.2 后，.NET 程序为何无法访问 LocalDB（MDF）数据库？

结论

这两次报错发生在不同阶段：

• 最初是数据库文件与引擎版本不兼容：MDF 的内部版本为 904，对应 SQL Server 2019；实际接收连接的引擎只支持 852 及以前的版本，对应 SQL Server 2016。
• 重新安装后，错误发生在 LocalDB 实例创建或启动时。LocalDB parent instance version is invalid: MSSQL13E.LOCALDB 表明实例配置仍涉及 SQL Server 2016 的父版本，需要检查旧实例记录是否与已安装的 LocalDB 运行时匹配。

目前的证据不足以将问题归因于 VS2022 17.13.2 或 Windows 11。应先确认测试机实际运行的 LocalDB 版本，再检查实例配置。

注册表中的 DataDirectory 无须与应用 MDF 所在目录一致。修改后恢复运行可以作为排查线索，但还不能说明原来的路径有误。

为什么修改安装先决条件后仍然报错？

连接字符串中的：

Data Source=(LocalDB)\MSSQLLocalDB

只指定了 LocalDB 实例名称，没有指定 SQL Server 2019，也不会根据 MDF 的版本自动选择兼容的引擎。

修改安装项目的先决条件，只会影响依赖组件的安装安排。现有的 MSSQLLocalDB 实例未必已经升级或重建，仍可能保留原有版本信息。

还要区分以下两个组件：

• SQL Server Express 的常规服务实例，例如 .\SQLEXPRESS。
• SQL Server Express LocalDB，通过 (LocalDB)\实例名 访问。

安装 SQL Server 2019 Express，并不代表一定安装了 SQL Server 2019 LocalDB。当前连接字符串使用的是后者。

Visual Studio 安装项目的先决条件通常由 setup.exe 引导程序处理。如果部署时直接运行 .msi，还需单独确认 LocalDB 运行时是否已安装。MSI 安装成功，也不代表数据库就能连接。

第一步：确认测试机的 LocalDB 版本与实例状态

用实际运行程序的 Windows 用户登录，在 PowerShell 中执行：

where.exe sqllocaldb
sqllocaldb versions
sqllocaldb info
sqllocaldb info MSSQLLocalDB

这些命令依次检查工具位置、已安装的 LocalDB 版本、当前用户可见的实例，以及指定实例的详细信息。

如果单独执行：

sqllocaldb info

只返回：

MSSQLLocalDB

这只能说明存在该名称的实例记录，无法确认它属于 SQL Server 2019，也无法确认它能否启动。

接着尝试启动实例：

sqllocaldb start MSSQLLocalDB

如果仍报父版本无效，应先检查 LocalDB 安装和实例注册信息。此时尚未进入正常附加业务数据库的阶段，修改 MDF 路径通常无法解决实例启动问题。

RegOpenKeyExW 返回错误码 2，表示这次注册表打开操作找不到指定目标。结合紧随其后的父版本错误，可能是旧版本注册信息残留，也可能是运行时注册不完整。不过，这两行日志没有指出具体缺失的注册表键，不能据此认定缺失的是 DataDirectory。

第二步：用明确版本的新实例验证

先备份业务数据库。正在使用的数据库应通过数据库备份方式保存，不要直接复制仍在写入的 MDF 文件。

如果 sqllocaldb versions 确认已安装 15.0 系列的 LocalDB，可以创建一个独立实例：

sqllocaldb create VRDBLocalDB 15.0
sqllocaldb start VRDBLocalDB
sqllocaldb info VRDBLocalDB

这些操作应在应用实际使用的 Windows 账户下执行。LocalDB 实例归属于用户，因此在安装账户或其他管理员账户下创建实例，不能直接代表应用用户的运行环境。

随后将连接字符串改为：

Data Source=(LocalDB)\VRDBLocalDB;AttachDbFilename=C:\Users\test\AppData\Roaming\Advanced Applications\VRDB\VRDB.mdf;Integrated Security=True;Connect Timeout=60

如果新实例能够启动并访问同一数据库，就可以重点检查原来的 MSSQLLocalDB 实例配置，无须先删除旧实例。

如果未安装 15.0，先安装相应的 LocalDB 运行时。若新实例也无法创建或启动，应检查 LocalDB 安装、实例日志和目录权限，必要时修复安装。反复修改业务数据库路径无法代替这些检查。

连接成功后，执行以下 SQL，核实当前连接实际使用的引擎：

SELECT
    SERVERPROPERTY('ProductVersion') AS ProductVersion,
    SERVERPROPERTY('Edition') AS Edition;

DataDirectory 为什么可以与 MDF 路径不同？

这几项配置的用途不同：

题目中的注册表值为：

C:\Users\test\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\MSSQLLocalDB

这个路径符合 LocalDB 默认实例目录的布局。LocalDB 在创建和管理实例时维护该目录，用于存放实例自身的系统数据库、日志等文件。

业务数据库可以放在：

C:\Users\test\AppData\Roaming\Advanced Applications\VRDB

两个目录各有用途，可以同时存在。当前连接字符串已通过 AttachDbFilename 指定业务 MDF 的完整绝对路径：

AttachDbFilename=C:\Users\test\AppData\Roaming\Advanced Applications\VRDB\VRDB.mdf

因此，无须把注册表中的实例目录改成业务数据库目录。

连接字符串采用下面这样的写法时，才会用到 .NET 的 |DataDirectory| 替换机制：

AttachDbFilename=|DataDirectory|\VRDB.mdf

在 .NET Framework 应用中，可以这样设置替换标记对应的目录：

AppDomain.CurrentDomain.SetData("DataDirectory", databaseDirectory);

它与 LocalDB 注册表中同名的 DataDirectory 是两项不同的设置。

修改注册表后为何恢复运行，现有日志还无法说明，需要结合修改前后的实例配置和启动日志判断。后续部署应使用 LocalDB 工具管理实例，避免将手工修改该注册表值作为安装步骤。

应用中的路径与连接代码

可以用 Path.Combine 生成路径，再用 SqlConnectionStringBuilder 构造连接字符串：

using System;
using System.Data.SqlClient;
using System.IO;

string databaseDirectory = Path.Combine(
    Environment.GetFolderPath(
        Environment.SpecialFolder.ApplicationData),
    AssyInfo.Company,
    AssyInfo.Product);

string databaseFile = Path.Combine(
    databaseDirectory,
    "VRDB.mdf");

if (!File.Exists(databaseFile))
{
    throw new FileNotFoundException(
        "未找到数据库文件。",
        databaseFile);
}

var builder = new SqlConnectionStringBuilder
{
    DataSource = @"(LocalDB)\VRDBLocalDB",
    AttachDBFilename = databaseFile,
    IntegratedSecurity = true,
    ConnectTimeout = 60
};

using (var connection = new SqlConnection(builder.ConnectionString))
{
    connection.Open();

    // 执行数据库操作。
}

这个示例假定 VRDBLocalDB 已经创建，安装或首次运行流程也已准备好数据库文件。

题目中的路径表达式还需核对：

@"{Environment.GetFolderPath(...)}\{AssyInfo.Company}\{AssyInfo.Product}"

如果实际代码确实这样写，@ 只表示逐字字符串，不会计算 {...} 中的表达式。字符串插值需要 $，例如 $@"..."。运行时既然已经得到正确的绝对路径，这里可能只是示例省略，仍建议核对实际代码。

部署时还要注意什么？

数据库一旦被较新引擎升级为较新的文件格式，就不能直接由旧引擎附加。降低数据库的 compatibility_level 也无法降低 MDF 的物理格式。若仍需支持 SQL Server 2016，应使用与其兼容的数据库文件，或通过适当的架构与数据迁移方式重新建立数据库。

应用升级时，安装程序应避免覆盖用户已有的 MDF。开发机上能运行的数据库副本，可能已经被较新引擎升级，因此打包前要核对实际分发的文件。

IDE 中运行正常，只能说明开发机当前账户、LocalDB 实例和文件权限满足要求，测试机仍需逐项验证。应用用户还应有权修改数据库所在目录，因为 SQL Server 附加和使用数据库时，可能需要创建或访问相关文件。

可以将 Windows 11 升级记为一次环境变化，但现有报错并未证明它改变了 MDF 的查找位置。ApplicationData 通常指向 Roaming，LocalDB 实例目录通常位于 Local，两种路径同时出现是正常现象。

备注：内容仅供参考。