EF Core 8执行add-migration时HierarchyId映射失败报错求助

错误信息 #

无法创建类型为''的'DbContext'。创建实例时抛出异常：'Node.HierarchyId的HierarchyId属性无法映射到数据库类型'hierarchyid'，因为数据库提供程序不支持将HierarchyId属性映射到hierarchyid列。请考虑映射到其他数据库类型，或使用值转换器将属性值转换为数据库支持的类型。或者，使用'[NotMapped]'特性或在OnModelCreating中使用'EntityTypeBuilder.Ignore'将该属性排除在模型之外。'。有关设计时支持的不同模式，请见相关文档。

相关配置代码 #

builder.Entity<Node>(b => {
        b.ConfigureBaseEntityProperties("Nodes");

        b.HasDiscriminator(c => c.Type)
         .HasValue<RoomNode>(NodeType.Room.ToString())
         .HasValue<EstimateNode>(NodeType.Estimate.ToString())
         .HasValue<FolderNode>(NodeType.Folder.ToString())
         .HasValue<AssignmentNode>(NodeType.Assignment.ToString());

        //Properties
        b.Property(q => q.Name).IsRequired().IsUnicode(false).HasMaxLength(150);
        b.Property(q => q.Type).IsRequired().IsUnicode(false).HasMaxLength(16);
        b.Property(e => e.HierarchyId)
           .HasColumnType("hierarchyid");
});

Configure<AbpDbContextOptions>(options =>
        {
            /* The main point to change your DBMS.
             * See also RestorNetMigrationsDbContextFactory for EF Core tooling. */
            options.UseSqlServer(optionsBuilder =>
            {
                optionsBuilder.UseQuerySplittingBehavior(QuerySplittingBehavior.SingleQuery);
                optionsBuilder.UseHierarchyId();
            });
        });

解决方案 #

• 检查设计时DbContext工厂配置：EF Core迁移工具在设计时会使用专门的DbContext工厂（比如代码注释中提到的RestorNetMigrationsDbContextFactory），必须确保该工厂的CreateDbContext方法中，配置SqlServer时同样调用了UseHierarchyId()。运行时的配置不会被迁移工具直接使用，这是常见遗漏点。
• 确认NuGet包依赖：必须安装Microsoft.EntityFrameworkCore.SqlServer.HierarchyId包，这是EF Core支持SqlServer HierarchyId类型的核心依赖，缺失该包会直接导致类型映射失败。
• 验证实体属性类型：确保Node实体中的HierarchyId属性类型是Microsoft.EntityFrameworkCore.SqlServer.HierarchyId，而非自定义类型或其他命名空间下的同名类型。
• 手动配置值转换器（可选）：如果上述步骤仍未解决问题，可以在属性配置中显式添加值转换器，强制处理类型转换：

  b.Property(e => e.HierarchyId)
    .HasColumnType("hierarchyid")
    .HasConversion(
        hierarchyId => hierarchyId.ToString(),
        stringValue => Microsoft.EntityFrameworkCore.SqlServer.HierarchyId.Parse(stringValue)
    );
  

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