添加依赖注入后Azure Function项目执行Add-Migration报错

排查及解决步骤 #

1. 校验配置文件路径与格式 #

• 确认local.settings.json位于项目根目录，且ConnectionStringToDb配置在Values节点下（Azure Function默认配置结构）：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "ConnectionStringToDb": "你的数据库连接字符串"
  }
}

• 将local.settings.json的复制到输出目录属性设置为「如果较新则复制」，避免设计时工具找不到配置文件。

2. 确保IDesignTimeDbContextFactory可被识别 #

• 保证ContosoDbContextFactory是public访问修饰符，且与ContosoDbContext在同一项目中；若采用分层架构（DbContext单独在类库），需将Factory放到DbContext所在类库，或执行迁移时指定项目：

# Package Manager Console命令
Add-Migration InitialCreate -Project 你的DbContext类库名 -StartupProject 你的Function项目名
Update-Database -Project 你的DbContext类库名 -StartupProject 你的Function项目名

3. 使用.NET CLI命令替代Package Manager Console #

Package Manager Console可能存在项目上下文识别问题，改用CLI命令更稳定：

# 单项目结构
dotnet ef migrations add InitialCreate
dotnet ef database update

# 分层结构
dotnet ef migrations add InitialCreate --project ./你的DbContext类库路径 --startup-project ./你的Function项目路径
dotnet ef database update --project ./你的DbContext类库路径 --startup-project ./你的Function项目路径

4. 统一EF Core包版本 #

确认所有EF Core相关包（Microsoft.EntityFrameworkCore.Design、Microsoft.EntityFrameworkCore.SqlServer、Microsoft.EntityFrameworkCore.Tools）版本均为6.0.0，避免版本不一致导致兼容性问题；同时确保Function项目目标框架为.NET 6。

5. 捕获详细错误信息 #

原报错过于笼统，修改Factory代码添加异常捕获，输出具体错误：

public class ContosoDbContextFactory : IDesignTimeDbContextFactory<ContosoDbContext>
{
    public ContosoDbContext CreateDbContext(string[] args)
    {
        try
        {
            IConfigurationRoot configuration = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("local.settings.json", optional: false, reloadOnChange: true)
                .Build();

            var connectionString = configuration["ConnectionStringToDb"];
            if (string.IsNullOrEmpty(connectionString))
            {
                throw new InvalidOperationException("未找到ConnectionStringToDb配置项");
            }

            var builder = new DbContextOptionsBuilder<ContosoDbContext>();
            builder.UseSqlServer(connectionString);

            return new ContosoDbContext(builder.Options);
        }
        catch (Exception ex)
        {
            Console.WriteLine($"创建DbContext失败：{ex.ToString()}");
            throw;
        }
    }
}

重新执行迁移命令，通过控制台输出的详细信息定位具体问题（如连接字符串为空、配置文件缺失、实体无主键等）。

6. 检查DbContext与实体配置 #

• 确保ContosoDbContext的构造函数为public；
• 确认ContosoTable实体类已配置主键（EF Core要求每个实体必须有主键，否则会触发设计时错误）。

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