Oqtane模块开发：Entity Framework迁移命令无法运行，求解决办法

问题根源 #

Oqtane自定义DbContext依赖Oqtane.Repository.IDBContextDependencies接口，但EF迁移/更新命令默认不会初始化Oqtane的依赖注入容器，导致无法解析该服务，进而创建QuickLinksContext实例失败。

解决步骤 #

1. 添加设计时DbContext工厂类 #

在模块项目的Repository目录下，创建实现IDesignTimeDbContextFactory<QuickLinksContext>的工厂类，手动提供DbContext的创建逻辑：

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

namespace Baydn.Module.Contact.Repository
{
    public class QuickLinksContextFactory : IDesignTimeDbContextFactory<QuickLinksContext>
    {
        public QuickLinksContext CreateDbContext(string[] args)
        {
            // 加载项目配置文件
            var config = new ConfigurationBuilder()
                .SetBasePath(Directory.GetCurrentDirectory())
                .AddJsonFile("appsettings.json")
                .Build();

            // 配置DbContext选项
            var optionsBuilder = new DbContextOptionsBuilder<QuickLinksContext>();
            optionsBuilder.UseSqlServer(config.GetConnectionString("DefaultConnection"));

            // 实例化Oqtane默认的DBContext依赖实现
            var dbDependencies = new DBContextDependencies();

            return new QuickLinksContext(optionsBuilder.Options, dbDependencies);
        }
    }
}

2. 确认DbContext构造函数正确性 #

确保你的QuickLinksContext构造函数正确接收所需参数：

public class QuickLinksContext : DbContext, ITransientService
{
    private readonly IDBContextDependencies _dbContextDependencies;

    public QuickLinksContext(DbContextOptions<QuickLinksContext> options, IDBContextDependencies dbContextDependencies) 
        : base(options)
    {
        _dbContextDependencies = dbContextDependencies;
    }

    // 定义你的DbSet和其他配置
    public DbSet<YourEntity> YourEntities { get; set; }
}

3. 正确执行EF命令 #

打开命令行，切换到模块项目目录，执行以下命令（需指定Oqtane Server项目为启动项目，确保配置加载完整）：

• 创建新迁移：

dotnet ef migrations add [迁移名称] --project . --startup-project ../../Oqtane.Server

• 更新数据库：

dotnet ef database update --project . --startup-project ../../Oqtane.Server

4. 其他注意事项 #

• 若使用非SQL Server数据库，将UseSqlServer替换为对应数据库的EF扩展方法（如PostgreSQL用UseNpgsql），并确保安装了对应的EF Core NuGet包。
• 连接字符串可直接硬编码在工厂类中（仅用于设计时迁移），但从配置文件读取更符合项目规范。

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