ASP.NET应用Mac端执行update-database报错：无法创建ApplicationDbContext实例

核心原因 #

EF Core迁移工具在Mac环境下无法通过依赖注入体系正确实例化ApplicationDbContext，而非数据库连接问题。这是因为：

• .NET 6+引入的顶级Program.cs结构，在部分非Windows环境中，EF工具无法完整解析服务配置流程
• 缺少设计时DbContext工厂，导致工具无法独立创建DbContext实例

解决方案 #

方案1：添加设计时DbContext工厂 #

创建ApplicationDbContextFactory类，让EF工具直接通过该工厂创建DbContext，绕开依赖注入解析的问题：

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

namespace ProjectFlow.Data
{
    public class ApplicationDbContextFactory : IDesignTimeDbContextFactory<ApplicationDbContext>
    {
        public ApplicationDbContext CreateDbContext(string[] args)
        {
            // 读取配置文件
            var configuration = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json")
                .Build();

            // 构建DbContext选项
            var optionsBuilder = new DbContextOptionsBuilder<ApplicationDbContext>();
            var connectionString = configuration.GetConnectionString("DefaultConnection");
            optionsBuilder.UseSqlServer(connectionString);

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

添加完成后，重新执行update-database命令即可。

方案2：确保EF工具与项目依赖版本一致 #

Mac上的dotnet ef工具版本如果和项目中EF Core包版本不匹配，也会导致实例化失败：

1. 更新全局EF工具：

dotnet tool update --global dotnet-ef

2. 检查项目中Microsoft.EntityFrameworkCore.SqlServer、Microsoft.EntityFrameworkCore.Tools的版本，确保与工具版本完全一致。

方案3：后续数据库适配（可选） #

解决DbContext创建问题后，你会遇到预期的数据库连接错误（因为Mac未安装SQL Server）。此时可以：

• 连接远程Windows上的SQL Server实例（需确保网络互通）
• 切换到SQLite等跨平台数据库（修改连接字符串和UseSqlServer为UseSqlite）
• 安装Azure SQL Edge等支持Mac的SQL Server兼容版本

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