EF Core怎么处理decimal精度 EF Core HasPrecision配置方法_技术教程

EF Core中decimal精度配置首选HasPrecision方法，在OnModelCreating中显式调用并确保base.OnModelCreating最后执行；可辅以自定义特性批量标记，或全局配置Properties()，但需注意迁移更新与优先级冲突。

EF Core 默认把 decimal 映射为数据库的 decimal(18,2)，这在多数财务场景下不够用——比如需要保留3位小数（如重量、利率），或总位数超18（如大额交易金额）。关键不是“能不能设”，而是“在哪设、怎么设才稳定生效”。

直接用 HasPrecision 配置单个字段

这是最常用也最可靠的方式，必须在 OnModelCreating 中显式调用，并确保 base.OnModelCreating(modelBuilder) 在最后执行：

HasPrecision(precision, scale) 是语义级配置，EF Core 会据此生成对应数据库类型（如 SQL Server 的 decimal(10,3)）
不要和 HasColumnType("decimal(10,3)") 混用，后者是硬编码字符串，绕过 EF 的类型推导，容易与迁移冲突
示例：modelBuilder.Entity().Property(x => x.TaxAmount).HasPrecision(12, 4);

用自定义特性统一标记 decimal 字段

适合中大型项目，避免在 OnModelCreating 里逐个写重复代码。先定义特性：

[AttributeUsage(AttributeTargets.Property)]
public class DecimalPrecisionAttribute : Attribute
{
    public byte Precision { get; }
    public byte Scale { get; }
    public DecimalPrecisionAttribute(byte precision = 18, byte scale = 2)
    {
        Precision = precision;
        Scale = scale;
    }
}

然后在实体属性上使用：

[DecimalPrecision(10, 2)]
public decimal UnitPrice { get; set; }

再在 OnModelCreating 中批量扫描并应用：

遍历所有实体类型 → 找出带该特性的 decimal 属性 → 调用 HasPrecision
注意：必须在 base.OnModelCreating 之前完成扫描和配置，否则会被覆盖

全局修改所有 decimal 的默认精度（慎用）

EF Core 6+ 支持按类型批量配置：

modelBuilder.Properties()
    .Configure(c => c.HasPrecision(10, 2));

这个写法会作用于**所有未被单独配置过的 decimal 属性**，包括导航属性中的 decimal（如有）。优点是省事，缺点是灵活性差——比如你有一个 Rate 字段需要 (5,4)，就得额外再单独覆盖一次。

常见失效原因和避坑点

很多“配置不生效”其实不是代码问题，而是环境或操作细节没到位：

没运行 dotnet ef migrations add xxx 重新生成迁移脚本 —— 配置只影响新迁移，不会自动修正已有表结构
SQL Server 中已存在的列类型是 decimal(18,2)，但迁移没包含 AlterColumn 操作 → 检查迁移文件里是否有对应变更
用了 [Column(TypeName = "decimal(10,2)")] 但没生效 → 这个特性在较新 EF Core 版本中已被弱化，优先级低于 Fluent API，建议弃用
前端传入 3 位小数但存进库只剩 2 位 → 先确认数据库列实际类型（用 SSMS 查看表定义），再确认 EF 是否真生成了带 scale 的迁移

基本上就这些。核心逻辑很清晰：HasPrecision 是推荐入口，特性用于组织，全局配置仅作兜底。只要迁移跟得上、类型对得准，decimal 精度就不会丢。