EF Core 7中一个DbContext迁移成功另一个失败的问题求助

问题概述 #

项目基于EF Core v7.0.18开发，包含GlobalDbContext与ConfigurationDbContext两个DbContext。执行迁移命令时，GlobalDbContext可正常生成迁移文件，但ConfigurationDbContext报错无法创建实例，已确认两个DbContext均实现无参构造函数。

迁移命令对比 #

成功的GlobalDbContext迁移命令 #

dotnet ef migrations add 
--project Doma.DataLayer/Doma.DataLayer.csproj 
--startup-project Doma.DataLayer.Tests/Doma.DataLayer.Tests.csproj 
--context Doma.DataLayer.Global.Models.GlobalDbContext 
--configuration Debug 
--framework net7.0 Initial 
--output-dir Global/Migrations

失败的ConfigurationDbContext迁移命令 #

dotnet ef migrations add --project Doma.DataLayer/Doma.DataLayer.csproj 
--startup-project Doma.DataLayer.Tests/Doma.DataLayer.Tests.csproj 
--context Doma.DataLayer.Configuration.Models.ConfigurationDbContext 
--configuration Debug --framework net7.0 Initial 
--output-dir Configuration/Migrations

错误信息 #

Unable to create an object of type 'ConfigurationDbContext'. For the different patterns supported at design time, see [相关文档]
Process terminated with exit code 1

DbContext核心代码差异 #

可正常工作的GlobalDbContext核心逻辑 #

public partial class GlobalDbContext : DbContext
{
    public GlobalDbContext() { }
    public GlobalDbContext(DbContextOptions<GlobalDbContext> options) : base(options) { }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        if (!optionsBuilder.IsConfigured)
        {
            optionsBuilder.UseSqlite("Data Source=TempGlobalDatabas.db");
        }
    }
}

迁移失败的ConfigurationDbContext核心逻辑 #

public partial class ConfigurationDbContext : DbContext
{
    public ConfigurationDbContext(DbContextOptions<ConfigurationDbContext> options) : base(options) { }
    public ConfigurationDbContext() { }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        if (!optionsBuilder.IsConfigured)
        {
            optionsBuilder.UseSqlite("Data Source=Configuration.db");
        }
        // 重复执行配置语句，可能引发冲突
        optionsBuilder.UseSqlite("Data Source=Configuration.db");
    }
}

解决方案 #

1. 修复OnConfiguring方法的重复配置问题 #

将ConfigurationDbContext中多余的UseSqlite调用移到判断分支内，避免重复配置导致的实例化异常：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    if (!optionsBuilder.IsConfigured)
    {
        optionsBuilder.UseSqlite("Data Source=Configuration.db");
    }
}

2. 添加设计时DbContext工厂 #

若启动项目未注册ConfigurationDbContext，可在Doma.DataLayer项目中添加设计时工厂，帮助EF Core工具直接创建DbContext实例：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;

namespace Doma.DataLayer.Configuration.Models;

public class ConfigurationDbContextFactory : IDesignTimeDbContextFactory<ConfigurationDbContext>
{
    public ConfigurationDbContext CreateDbContext(string[] args)
    {
        var optionsBuilder = new DbContextOptionsBuilder<ConfigurationDbContext>();
        optionsBuilder.UseSqlite("Data Source=Configuration.db");

        return new ConfigurationDbContext(optionsBuilder.Options);
    }
}

3. 修正代码缩进问题 #

检查ConfigurationDbContext的命名空间缩进，移除多余空格，避免反射时的类路径识别错误：

// 修正前（含多余空格）
    namespace Doma.DataLayer.Configuration.Models;

// 修正后
namespace Doma.DataLayer.Configuration.Models;

4. 清理缓存并重建项目 #

• 删除项目根目录下的bin和obj文件夹
• 执行dotnet clean和dotnet build命令重建项目
• 重新运行迁移命令

5. 在迁移命令中直接指定连接字符串 #

通过--connection参数直接传入连接字符串，绕过OnConfiguring的配置逻辑：

dotnet ef migrations add Initial
--project Doma.DataLayer/Doma.DataLayer.csproj 
--startup-project Doma.DataLayer.Tests/Doma.DataLayer.Tests.csproj 
--context Doma.DataLayer.Configuration.Models.ConfigurationDbContext 
--configuration Debug 
--framework net7.0 
--output-dir Configuration/Migrations
--connection "Data Source=Configuration.db"

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