.NET MAUI应用中EF Core迁移失败：虚拟项目无效的解决方法

为什么虚拟控制台项目会要求DbContext？ #

EF Core迁移工具需要定位到你的DbContext实例来分析实体模型、生成迁移脚本。控制台项目作为启动项目时，工具默认会在该项目中查找DbContext，但你的DbContext实际存在于MAUI项目中，所以必须明确告诉工具去哪里找它。

正确操作步骤 #

1. 准备控制台项目

   • 创建与MAUI项目目标框架一致的.NET Core控制台项目（比如均为.NET 8）
   • 给控制台项目安装和MAUI项目版本完全匹配的EF Core包：
     • Microsoft.EntityFrameworkCore.Tools
     • 对应数据库的Provider包（如Microsoft.EntityFrameworkCore.Sqlite）

2. 让工具定位到MAUI项目的DbContext
   两种方式二选一：

   • 方式一：添加项目引用
     右键控制台项目 → 添加 → 项目引用 → 选中你的MAUI项目，这样工具就能通过控制台项目找到MAUI里的DbContext
   • 方式二：执行命令时显式指定
     在包管理器控制台执行迁移命令时，明确指定DbContext所在的MAUI项目、启动项目和DbContext类型：

     Add-Migration InitialCreate -Project 你的MAUI项目名称 -StartupProject 你的控制台项目名称 -Context 你的DbContext类名
     

     用CLI命令的话：

     dotnet ef migrations add InitialCreate --project 你的MAUI项目名称 --startup-project 你的控制台项目名称 --context 你的DbContext类名
     

3. 关键校验点

   • 确保你的DbContext类是非抽象、非泛型的，且有可访问的构造函数（无参构造或带DbContextOptions<YourDbContext>的构造均可）
   • 如果MAUI项目的DbContext需要配置参数，可在控制台项目的Program.cs中临时添加测试配置（仅用于让工具识别DbContext，不影响实际迁移逻辑）：

     using 你的MAUI项目命名空间;
     using Microsoft.EntityFrameworkCore;
     
     var options = new DbContextOptionsBuilder<你的DbContext类名>()
         .UseSqlite("Data Source=temp.db") // 临时数据库连接字符串
         .Options;
     
     using var dbContext = new 你的DbContext类名(options);
     

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