WinUI3使用GenericHost模式时Add-Migration执行失败求助

问题场景 #

之前在WinUI3项目中用Design-Time Factory模式可正常执行EF Core的Add-Migration命令，但引入GenericHost改用Application Service模式（避免硬编码连接字符串）后，执行以下命令时出现异常：

Add-Migration InitialCreate2 -Context BusinessDomainContext -OutputDir Migrations\BusinessDomain

具体错误为：无法加载Microsoft.ui.xaml.dll，且无法创建BusinessDomainContext实例。

已尝试的方案及局限 #

• 在项目的*.csproj文件中添加<WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>：错误提示消失，但Add-Migration命令无后续执行动作，无法生成迁移文件
• 添加DISABLE_XAML_GENERATED_MAIN编译定义并自定义Program.cs入口：可正常生成迁移，但需要修改项目默认启动逻辑，方案不够优雅

官方适配现状及期待方向 #

目前GitHub上有2022年开放的相关问题，官方暂未推出正式适配方案，但可重点关注以下更新方向：

• EF Core设计时工具对WinUI3 GenericHost场景的原生支持：希望后续版本中，设计时工具能自动识别WinUI3的GenericHost配置，无需修改项目文件或入口即可初始化上下文
• WinUI3 SDK对设计时环境的优化：解决Microsoft.ui.xaml.dll在非UI启动场景下的加载问题，让EF Core设计时工具能正常运行
• 官方文档补充：针对WinUI3+GenericHost+EF Core的组合场景，提供官方推荐的设计时配置流程

更优雅的临时解决方案 #

1. 保留精简版Design-Time Factory #

无需完全抛弃原有模式，在项目中添加一个极简的Design-Time Factory，和GenericHost共用同一配置源，既避免硬编码连接字符串，也不用修改项目入口：

public class BusinessDomainContextFactory : IDesignTimeDbContextFactory<BusinessDomainContext>
{
    public BusinessDomainContext CreateDbContext(string[] args)
    {
        // 读取和GenericHost一致的配置文件
        var configBuilder = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

        var configuration = configBuilder.Build();
        var options = new DbContextOptionsBuilder<BusinessDomainContext>()
            .UseSqlServer(configuration.GetConnectionString("BusinessDomain"))
            .Options;

        return new BusinessDomainContext(options);
    }
}

添加后直接执行原Add-Migration命令即可正常生成迁移。

2. 排查无动作问题的细节 #

如果坚持使用<WindowsAppSDKSelfContained>true的方案，可添加--verbose参数执行命令，查看无后续动作的具体原因：

Add-Migration InitialCreate2 -Context BusinessDomainContext -OutputDir Migrations\BusinessDomain --verbose

根据日志提示调整配置（比如连接字符串读取路径、权限等），部分场景下可解决无动作问题。

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