如何关闭Entity Framework Core 5所有约定并手动构建完整数据模型

异常原因 #

你遇到的Sequence contains no elements异常是因为手动创建的RelationalModel为空，仅给模型添加了空的RelationalModel注解，没有填充实体与表、属性与列的映射元数据，EF 查询时无法找到实体对应的表信息，触发了Linq的Single()方法无匹配项异常。

具体修复步骤 #

1. 替换ModelBuilder初始化逻辑，正确清空所有约定 #

默认的new ModelBuilder()会加载所有EF内置约定，会自动生成影子属性等非预期配置，正确的无约定ModelBuilder初始化方式如下：

// 先基于当前数据库提供程序创建约定集
var dbContext = new TContext();
var conventionSet = ConventionSet.CreateConventionSet(dbContext);

// 清空所有核心约定
conventionSet.EntityTypeAddedConventions.Clear();
conventionSet.EntityTypeAnnotationChangedConventions.Clear();
conventionSet.EntityTypeBaseTypeChangedConventions.Clear();
conventionSet.EntityTypeMemberIgnoredConventions.Clear();
conventionSet.EntityTypePrimaryKeyChangedConventions.Clear();
conventionSet.ForeignKeyAddedConventions.Clear();
conventionSet.ForeignKeyAnnotationChangedConventions.Clear();
conventionSet.ForeignKeyDependentRequirednessChangedConventions.Clear();
conventionSet.ForeignKeyRequirednessChangedConventions.Clear();
conventionSet.ForeignKeyUniquenessChangedConventions.Clear();
conventionSet.IndexAddedConventions.Clear();
conventionSet.IndexAnnotationChangedConventions.Clear();
conventionSet.IndexUniquenessChangedConventions.Clear();
conventionSet.KeyAddedConventions.Clear();
conventionSet.KeyAnnotationChangedConventions.Clear();
conventionSet.ModelAnnotationChangedConventions.Clear();
conventionSet.ModelFinalizedConventions.Clear();
conventionSet.ModelFinalizingConventions.Clear();
conventionSet.ModelInitializedConventions.Clear();
conventionSet.PropertyAddedConventions.Clear();
conventionSet.PropertyAnnotationChangedConventions.Clear();
conventionSet.PropertyFieldChangedConventions.Clear();
conventionSet.PropertyNullabilityChangedConventions.Clear();

// 清空所有关系型数据库专属约定
var relationalConventionSet = conventionSet.Relational();
relationalConventionSet.EntityTypeTableNameChangedConventions.Clear();
relationalConventionSet.PropertyColumnTypeChangedConventions.Clear();
relationalConventionSet.ForeignKeyConstraintNameChangedConventions.Clear();
relationalConventionSet.IndexNameChangedConventions.Clear();
relationalConventionSet.KeyNameChangedConventions.Clear();

// 用清空后的约定集创建ModelBuilder
var modelBuilder = new ModelBuilder(conventionSet);

2. 删除自定义的FinalizeRelationalModel扩展方法 #

你之前手动创建RelationalModel的逻辑是错误的，直接删除FinalizeRelationalModel方法，替换为调用EF原生的FinalizeModel()即可：

// 原代码 var model = modelBuilder.FinalizeRelationalModel();
// 替换为
var model = modelBuilder.FinalizeModel();

EF Core的SQL Server提供程序会在FinalizeModel阶段自动生成完整的、包含所有表、列、约束映射关系的RelationalModel，不需要手动干预。

3. 补充必填元数据校验 #

在调用FinalizeModel之前，确保所有实体都已经配置了以下必填信息：

• 实体对应的表名、Schema名
• 主键配置
• 所有映射属性对应的列名、列类型
• 外键关联的主从实体、外键列映射

可添加以下校验逻辑提前发现配置缺失：

foreach (var entityType in modelBuilder.Model.GetEntityTypes())
{
    if (string.IsNullOrEmpty(entityType.GetTableName()))
        throw new InvalidOperationException($"实体 {entityType.ClrType.Name} 未配置表名");
    if (entityType.FindPrimaryKey() == null)
        throw new InvalidOperationException($"实体 {entityType.ClrType.Name} 未配置主键");
    foreach (var property in entityType.GetProperties())
    {
        if (string.IsNullOrEmpty(property.GetColumnName()))
            throw new InvalidOperationException($"实体 {entityType.ClrType.Name} 的属性 {property.Name} 未配置列名");
    }
}

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