执行Update-DataBase迁移命令时遇同名数据库错误的解决方法

问题说明 #

执行Update-Database -v迁移命令时，弹出错误：

尝试为文件Bookinist.mdf附加自动命名数据库失败。存在同名数据库，或指定文件无法打开，或位于UNC共享。

需要修复该错误，完成数据库创建，同时满足：

• 搭建WPF Core3.1应用层
• 基于EF Core实现数据库操作层
• 迁移需在应用层（Migration EF Wpf Core 31.v6）中创建数据库

现有配置与错误触发流程 #

连接字符串配置（appsettings.json） #

{
  "ConnectionStrings": {
    "DataBase": "Data Source=(localdb)\\MSSQLLocalDB;AttachDbFileName=Bookinist.mdf;Integrated Security=True"
  }
}

上下文注入配置（App.xaml.cs） #

public partial class App : Application
{       
        public static IHostBuilder CreateHostBuilder(string[] args) => Microsoft.Extensions.Hosting.Host
                .CreateDefaultBuilder(args)
                .ConfigureServices(
                    (hostContext, services) => services
                       .AddDbContext<ContextDBBookinist>(opt =>
                       {                           
                           opt.UseSqlServer(hostContext.Configuration.GetConnectionString("Database"));
                       } 
                    )
        );
}

错误重现步骤 #

1. 在Package Manager Console里把默认项目设为MigrationEFWpfCore31.v6.DAL
2. 执行Add-Migration Initial -v，成功生成迁移文件
3. 执行Update-Database -v，触发上述错误

已尝试的无效操作 #

修改连接字符串加入[DataDirectory]，并在代码里替换为当前目录：

{
  "ConnectionStrings": {
    "DataBase": "Data Source=(localdb)\\MSSQLLocalDB;AttachDbFileName=[DataDirectory]\\App_Data\\Bookinist.mdf;Integrated Security=True"
  }
}

public partial class App : Application
{   
    public static IHostBuilder CreateHostBuilder(string[] args) => Microsoft.Extensions.Hosting.Host
            .CreateDefaultBuilder(args)
            .ConfigureServices(
                (hostContext, services) => services
                    .AddDbContext<ContextDBBookinist>(opt =>
                    {
                        string path = Directory.GetCurrentDirectory();
                        opt.UseSqlServer(hostContext.Configuration.GetConnectionString("Database")
                            .Replace("[DataDirectory]", path));
                    } 
                )
    );
}

重新执行迁移命令后，错误依旧。

有效修复方案 #

方案1：改用LocalDB自动管理数据库文件（推荐） #

删掉连接字符串里的AttachDbFileName，直接指定数据库名称，让LocalDB自动处理文件存储：

{
  "ConnectionStrings": {
    "DataBase": "Data Source=(localdb)\\MSSQLLocalDB;Database=BookinistDB;Integrated Security=True"
  }
}

这种方式不用手动处理mdf文件路径，LocalDB会把数据库文件存在默认目录（一般是C:\Users\<你的用户名>\AppData\Local\Microsoft\Microsoft SQL Server Local DB\Instances\MSSQLLocalDB），能避免路径权限、文件冲突这类问题。

方案2：确保mdf文件路径存在且权限足够 #

如果一定要手动指定mdf路径：

1. 确认应用层项目的输出目录（比如bin\Debug\netcoreapp3.1）里有App_Data文件夹，并且程序有读写权限
2. 用绝对路径替换相对路径，示例：

{
  "ConnectionStrings": {
    "DataBase": "Data Source=(localdb)\\MSSQLLocalDB;AttachDbFileName=C:\\Projects\\MigrationEFWpfCore31.v6\\MigrationEFWpfCore31.v6\\App_Data\\Bookinist.mdf;Integrated Security=True"
  }
}

注意：绝对路径里的反斜杠要转义，或者直接用正斜杠。

方案3：清理LocalDB里的同名数据库 #

如果LocalDB中已经存在同名数据库，先清理：

1. 打开命令提示符，执行sqllocaldb info MSSQLLocalDB确认实例状态
2. 执行sqllocaldb stop MSSQLLocalDB停止实例
3. 执行sqllocaldb delete MSSQLLocalDB删除实例（警告：这会删掉该实例下所有数据库，谨慎操作）
4. 重新创建并启动实例：sqllocaldb create MSSQLLocalDB、sqllocaldb start MSSQLLocalDB
5. 再次执行Update-Database -v

方案4：统一EF Core版本 #

当前项目里EF Core版本不统一（应用层用5.0.0，DAL用5.0.0-rc.2），可能引发兼容性问题：
把所有EF Core相关包统一为适配netcoreapp3.1的稳定版本（比如5.0.17）：

• 应用层项目（MigrationEFWpfCore31.v6.csproj）修改：

<PackageReference Include="Microsoft.EntityFrameworkCore" Version="5.0.17" />
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="5.0.17" />
<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.17" />

• DAL项目（MigrationEFWpfCore31.v6.DAL.csproj）修改：

<PackageReference Include="Microsoft.EntityFrameworkCore" Version="5.0.17" />
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="5.0.17" />

验证步骤 #

1. 在Package Manager Console里把默认项目改成应用层（MigrationEFWpfCore31.v6）——因为要求迁移在应用层创建数据库
2. 如果之前生成过迁移，先执行Remove-Migration清理，再执行Add-Migration Initial -v
3. 执行Update-Database -v，验证数据库是否创建成功

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