在EF Core中，实体模型通常在DbContext的OnModelCreating方法里通过ModelBuilder静态配置。但在实际项目中，我们常常需要在运行时根据外部配置、插件或租户信息动态添加实体类型。EF Core提供了灵活的模型构建接口，可以在不修改编译期代码的情况下完成这一目标。
为什么需要运行时动态添加实体
常见的需求包括：模块化系统加载新业务模块时注册新表、SaaS平台按租户动态建表、低代码平台让用户自定义字段并映射为实体。如果把这些写死在DbContext里，会导致发布频繁且难以维护。
核心思路：使用ModelBuilder动态注册
EF Core的模型是在上下文初始化时由ModelBuilder构建的。我们可以通过反射或配置中心拿到运行时类型，再调用Entity方法完成映射。
示例：从程序集动态加载实体
假设我们有一个接口标记动态实体：
// 标记动态实体接口
public interface IDynamicEntity { }
// 运行时发现的实体类
public class TempLog : IDynamicEntity
{
public int Id { get; set; }
public string Message { get; set; }
}
在DbContext中动态添加：
using Microsoft.EntityFrameworkCore;
using System.Reflection;
public class AppDbContext : DbContext
{
private readonly IEnumerable<Type> _dynamicTypes;
public AppDbContext(DbContextOptions<AppDbContext> options, IEnumerable<Type> dynamicTypes)
: base(options)
{
_dynamicTypes = dynamicTypes;
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
foreach (var type in _dynamicTypes)
{
if (typeof(IDynamicEntity).IsAssignableFrom(type))
{
// 动态调用Entity(type)方法
var method = modelBuilder.GetType()
.GetMethods()
.First(m => m.Name == "Entity" && m.IsGenericMethod)
.MakeGenericMethod(type);
method.Invoke(modelBuilder, null);
// 可在这里配置表名
modelBuilder.Entity(type).ToTable("dyn_" + type.Name);
}
}
base.OnModelCreating(modelBuilder);
}
}
避免模型缓存冲突
EF Core默认会缓存模型以提升性能。如果不同租户或配置对应不同模型，需要自定义IModelCacheKeyFactory，让缓存键包含动态信息。
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Infrastructure;
using System;
public class DynamicModelCacheKeyFactory : IModelCacheKeyFactory
{
public object Create(DbContext context)
{
if (context is AppDbContext app)
{
// 用动态类型列表生成缓存键
var key = string.Join(",", app.DynamicTypeNames);
return (context.GetType(), key);
}
return context.GetType();
}
}
在配置上下文中替换该工厂：
var options = new DbContextOptionsBuilder<AppDbContext>()
.UseSqlServer("Server=127.0.0.1;Database=test;Trusted_Connection=True;")
.ReplaceService<IModelCacheKeyFactory, DynamicModelCacheKeyFactory>()
.Options;
注意事项
- 动态模型增加了迁移复杂度，建议配合脚本或按需迁移工具。
- 反射调用Entity方法有一定性能开销，应在启动时一次性构建。
- 使用<code>ToTable</code>等API时要注意名称冲突。
小结
通过ModelBuilder在OnModelCreating中结合反射与配置，EF Core完全支持运行时动态添加实体模型。配合自定义模型缓存键，可安全用于多租户与插件化系统，是实现灵活数据层的重要手段。