如何解决C# WinForms程序异地运行LocalDB数据库连接错误？

我用C# WinForms开发了一款应用，以PricesDatabase.mdf作为本地数据库存储数据，app.config中的连接字符串配置如下：

<connectionStrings>
    <add name="MyConnectionString" 
         connectionString="Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=|DataDirectory|\PricesDatabase.mdf;Integrated Security=True;Connect Timeout=30"/>
</connectionStrings>

代码中通过以下方式获取连接字符串：

string connectionString = ConfigurationManager.ConnectionStrings["MyConnectionString"].ConnectionString;

使用Microsoft Visual Studio Installer Projects制作MSI和EXE安装包，已在前置条件中添加SQL Server 2019 Express Local DB，但安装后出现错误：

A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: SQL Network Interfaces, error: 50 - Local Database Runtime error occurred. Cannot create an automatic instance. See the Windows Application event log for error details.

1. 检查并修复LocalDB实例 #

• 以管理员身份打开命令提示符，执行sqllocaldb info查看已存在的实例：
  • 若没有MSSQLLocalDB实例，执行sqllocaldb create MSSQLLocalDB手动创建
  • 执行sqllocaldb start MSSQLLocalDB启动实例
• 若启动失败，打开事件查看器（Windows日志 -> 应用程序），查看具体错误日志排查权限或文件损坏问题

2. 修正|DataDirectory|的读写权限问题 #

• |DataDirectory|默认指向应用安装目录（如C:\Program Files\你的应用名），该目录默认只读，LocalDB无法创建日志文件
• 方案一：修改连接字符串，将数据库指向用户可读写的目录，比如：

  <add name="MyConnectionString" 
       connectionString="Data Source=(LocalDB)\MSSQLLocalDB;AttachDbFilename=%USERPROFILE%\Documents\PricesDatabase.mdf;Integrated Security=True;Connect Timeout=30"/>
  

• 方案二：在代码中动态设置DataDirectory（需在获取连接字符串前执行）：

  string writablePath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
  AppDomain.CurrentDomain.SetData("DataDirectory", writablePath);
  

3. 检查安装包的前置条件配置 #

• 确认Visual Studio Installer Projects中添加的SQL Server 2019 Express Local DB是完整安装包，而非仅依赖项
• 安装完成后，在控制面板→程序和功能中确认存在SQL Server 2019 LocalDB条目

4. 修复LocalDB安装 #

• 若LocalDB已安装但仍报错，打开控制面板→程序和功能，找到SQL Server 2019 LocalDB，选择「更改」→「修复」，完成后重启电脑

5. 验证实例名称匹配 #

• 执行sqllocaldb info查看所有可用实例，确保连接字符串中的(LocalDB)\MSSQLLocalDB与实际存在的实例名称完全一致

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