.NET Aspire项目中EF Core迁移命令执行失败的问题求助

问题原因分析 #

报错的核心原因是：Aspire宿主项目（AppHost）默认不会自动将API项目的输出文件（如DLL）复制到自身的输出目录，而EF Core迁移命令在以AppHost为启动项目时，会尝试在其输出目录中查找包含DbContext的API项目DLL，找不到就会抛出文件缺失的错误。

具体解决方法 #

方法1：修改AppHost项目的构建配置 #

打开EFPlayground.AppHost.csproj，添加以下配置，强制将API项目的输出文件复制到AppHost的输出目录：

<ItemGroup>
  <ProjectReference Include="..\EFPlayground\EFPlayground.csproj">
    <Private>true</Private>
    <CopyLocalSatelliteAssemblies>true</CopyLocalSatelliteAssemblies>
  </ProjectReference>
</ItemGroup>

保存后重新执行dotnet build，再运行迁移命令即可。

方法2：直接以API项目作为启动项目执行迁移 #

既然DbContext位于API项目中，可直接指定API项目为启动项目执行迁移（前提是API项目能独立读取数据库连接字符串）：

# 添加初始迁移
dotnet ef migrations add InitialCreate --project EFPlayground --startup-project EFPlayground

# 移除迁移
dotnet ef migrations remove --project EFPlayground --startup-project EFPlayground

如果API项目依赖Aspire的配置中心，可临时在API项目的appsettings.json中添加连接字符串，迁移完成后可保留或移除（Aspire运行时会自动覆盖该配置）。

方法3：添加设计时DbContext工厂 #

在API项目中创建设计时工厂类，让EF Core迁移时直接通过工厂获取DbContext，无需依赖启动项目的输出：

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

namespace EFPlayground;

public class AppDbContextDesignTimeFactory : IDesignTimeDbContextFactory<YourDbContext>
{
    public YourDbContext CreateDbContext(string[] args)
    {
        var config = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json")
            .Build();

        var options = new DbContextOptionsBuilder<YourDbContext>();
        options.UseSqlServer(config.GetConnectionString("DefaultConnection"));

        return new YourDbContext(options.Options);
    }
}

添加后，执行迁移命令时可省略--startup-project参数，EF Core会自动识别并使用该工厂创建DbContext。

.NET Aspire与EF Core迁移实践要点 #

• Aspire宿主项目的核心定位是服务编排，不建议作为EF迁移的启动项目，优先选择包含DbContext的业务项目（如API）。
• 若必须通过AppHost执行迁移，需确保业务项目的输出文件被复制到AppHost目录，或通过设计时工厂绕过启动项目依赖。
• 开发阶段可在业务项目中保留独立配置文件，方便迁移命令读取，Aspire运行时会通过配置提供器自动覆盖这些本地配置。

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