WinUI3中EF迁移无法读取App.xaml.cs导致迁移失败的解决方法

问题核心 #

EF Core设计时工具无法通过WinUI3的GenericHost正确获取WinUIContext实例，导致无法生成迁移文件。WinUI3作为桌面应用，设计时环境无法完整初始化GenericHost，因此需要通过设计时工厂直接提供DbContext实例。

解决方案步骤 #

1. 在WinUI3.Data项目中添加IDesignTimeDbContextFactory实现

创建一个类，实现IDesignTimeDbContextFactory<WinUIContext>，直接在设计时创建DbContext实例，绕过GenericHost的依赖：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
using Microsoft.Extensions.Configuration;
using System.IO;

namespace WinUI3.Data
{
    public class WinUIContextFactory : IDesignTimeDbContextFactory<WinUIContext>
    {
        public WinUIContext CreateDbContext(string[] args)
        {
            // 加载启动项目的配置文件（WinUI3项目的appsettings.json）
            var configuration = new ConfigurationBuilder()
                .SetBasePath(Path.Combine(Directory.GetCurrentDirectory(), "../WinUI3")) // 路径指向WinUI3项目根目录
                .AddJsonFile("appsettings.json")
                .Build();

            var optionsBuilder = new DbContextOptionsBuilder<WinUIContext>();
            optionsBuilder.UseSqlServer(configuration.GetConnectionString("WinUIContext"));

            return new WinUIContext(optionsBuilder.Options);
        }
    }
}

2. 确保WinUI3项目的appsettings.json配置正确

检查appsettings.json中是否包含正确的连接字符串，并且将文件的复制到输出目录设置为“始终复制”：

{
  "ConnectionStrings": {
    "WinUIContext": "Server=(localdb)\\mssqllocaldb;Database=WinUITest;Trusted_Connection=True;MultipleActiveResultSets=true"
  },
  // 其他配置...
}

3. 验证NuGet包引用

确保WinUI3.Data项目已安装以下NuGet包：

• Microsoft.EntityFrameworkCore
• Microsoft.EntityFrameworkCore.SqlServer
• Microsoft.EntityFrameworkCore.Tools

4. 执行正确的迁移命令

在Package Manager Console中执行以下命令（确保默认项目为WinUI3.Data）：

Add-Migration InitialCreate -Project WinUI3.Data -StartupProject WinUI3 -Verbose

额外说明 #

• 设计时工厂会被EF Core工具自动识别，无需额外配置，直接解决WinUI3环境下无法初始化GenericHost的问题。
• 如果仍有问题，清理解决方案并重新生成所有项目，确保编译输出最新。

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