创建支持Entity Framework Core的安装包 跨PC部署数据库异常

按优先级排查以下问题，全部处理完即可正常完成数据库初始化：

• 首先修正连接字符串配置
  90%的这类崩溃都是连接字符串写死了本机路径导致的。不要在连接字符串里写开发机的绝对路径（比如C:\Users\你的开发机用户名\xxx.mdf），统一用|DataDirectory|占位符指代数据库文件存放路径，标准LocalDB连接字符串格式如下：

  Server=(localdb)\MSSQLLocalDB;AttachDbFilename=|DataDirectory|\你的数据库文件名.mdf;Integrated Security=True;MultipleActiveResultSets=True
  

  注意WPF程序默认的|DataDirectory|指向程序安装目录，如果你的程序安装在Program Files这类普通用户无写入权限的路径，会导致库文件创建失败，需要在程序启动入口（App.xaml.cs的OnStartup方法）里手动把数据目录指向用户可写的AppData路径：

  protected override void OnStartup(StartupEventArgs e)
  {
      base.OnStartup(e);
      string appDataDir = Path.Combine(
          Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
          "你的应用程序名称"
      );
      Directory.CreateDirectory(appDataDir);
      AppDomain.CurrentDomain.SetData("DataDirectory", appDataDir);
      
      // 后续再初始化你的DbContext
  }
  

• 补充自动建库/执行迁移的初始化逻辑
  你本机运行正常是因为开发阶段已经手动生成过数据库文件和表结构，目标PC首次运行时不存在对应库，必须显式让EF Core完成初始化：
  • 如果不需要后续迭代更新表结构，初始化DbContext后直接调用_context.Database.EnsureCreated()，会自动判断库是否存在，不存在就创建完整的表结构。
  • 如果后续版本需要更新表结构，调用_context.Database.Migrate()，程序启动时会自动应用所有未执行的迁移脚本，注意打包时要把迁移生成的文件、EF Core相关的程序集全部包含在安装包内，不要遗漏。
• 核对目标PC的LocalDB安装正确性
  • 版本要匹配：如果你项目用的EF Core是6/7/8版本，目标PC必须安装SQL Server 2019及以上版本的LocalDB，老版本LocalDB存在兼容性问题无法连接。
  • 实例名要对应：默认的共享实例名是MSSQLLocalDB，不要在连接字符串里写开发机上自定义的私有实例名。安装完LocalDB后可以在目标PC的命令行执行sqllocaldb i MSSQLLocalDB确认实例存在，执行sqllocaldb s MSSQLLocalDB确认实例可以正常启动。
  • 位数要匹配：如果你的程序编译目标固定为x64，目标PC不能只装32位版本的LocalDB，建议编译时选AnyCPU避免位数不兼容问题。
• 检查安装包的依赖完整性
  打包时不要只拷贝主程序exe，要确保Microsoft.EntityFrameworkCore、Microsoft.EntityFrameworkCore.SqlServer、Microsoft.Data.SqlClient等依赖项全部被包含。如果嫌手动核对依赖麻烦，发布时直接选择「独立部署」模式，会把对应版本的.NET运行时和所有依赖一起打包，不需要目标PC额外安装组件。

快速排查技巧：先在目标PC上用SSMS工具手动连接(localdb)\MSSQLLocalDB实例，尝试手动附加mdf文件验证访问权限，如果SSMS都无法正常连接，优先排查LocalDB的安装和权限问题，不需要调整程序代码。

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