数据库不存在时EF Core与SQL Server的异常行为排查

问题背景 #

使用.NET Core 8、EF Core和SQL Server的桌面应用，删除测试数据库后启动时出现错误：

A connection was successfully established with the server, but then an error occurred during the login process. (provider: Shared Memory Provider, error: 0 - No process is on the other end of the pipe.

已知情况：

• 数据库存在时（即使是空库），仅出现模型相关的预期错误
• 同解决方案的ASP.NET Core项目使用相同SQL Server/凭据可正常创建并连接目标数据库
• sa账号可正常登录SSMS
• 已启用命名管道和TCP/IP协议

解决思路 #

• 确认EF Core初始化逻辑
  桌面应用不会像Web应用自动触发迁移，需在启动代码中主动执行数据库创建和迁移步骤：

  using var context = new YourDbContext();
  // 先确保数据库被创建，再执行迁移
  await context.Database.EnsureCreatedAsync();
  await context.Database.MigrateAsync();
  

  避免依赖EF Core的自动初始化，确保创建和迁移流程被明确触发。

• 调整连接字符串参数
  添加超时配置避免数据库创建过程中超时中断，并清理冗余符号：

  "Server=XXXXX\XXXXX;Database=XXXXX;User Id=sa;Password=XXXXX;TrustServerCertificate=true;Connect Timeout=30"
  

• 验证sa账号的数据库创建权限
  登录SSMS执行以下SQL，确认sa拥有创建数据库的权限：

  SELECT HAS_PERMS_BY_NAME(NULL, NULL, 'CREATE DATABASE');
  

  返回1表示有权限，返回0则需给sa账号添加对应权限。

• 开启EF Core详细日志排查
  在DbContext的OnConfiguring方法中添加日志输出，追踪创建过程的具体异常：

  protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
  {
      optionsBuilder.LogTo(Console.WriteLine, LogLevel.Information);
  }
  

• 检查SQL Server共享内存协议
  打开SQL Server配置管理器，确认SQL Server网络配置下的共享内存协议已启用，启用后重启SQL Server服务。

• 尝试以管理员身份运行应用
  桌面应用普通权限可能不足以创建数据库，右键以管理员身份启动应用验证是否存在权限问题。

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