通八洲科技

EF Core Required注解怎么用 EF Core非空约束设置方法

日期:2025-12-25 00:00 / 作者:月夜之吻
EF Core 中设置字段非空主要有数据注解(如 [Required])和 Fluent API 两种方式:前者直观但影响模型验证,后者灵活且仅作用于数据库;修改已有可空字段为非空时需先填充 NULL 数据再执行 AlterColumn。

EF Core 中设置字段为非空(即数据库列 NOT NULL),主要有两种方式:数据注解(Data Annotations)和 Fluent API。选哪种取决于你的设计偏好——注解更直观、适合简单场景;Fluent API 更灵活、适合集中配置或规避 UI 验证干扰。

用 [Required] 注解快速设为非空

在实体属性上加 [Required],EF Core 会在迁移生成时自动把对应列设为 NOT NULL

public class Product
{
    public int Id { get; set; }
    [Required]          // → 数据库中 Name 列将为 NOT NULL
    public string Name { get; set; }
    [Required]
    public decimal Price { get; set; }
}

注意:如果项目启用了 C# 可空引用类型(enable),string Name 默认会被视为可空,此时 [Required] 不仅影响数据库,也参与模型验证(比如 MVC 绑定或 API 模型验证)。若只想约束数据库而不触发前端校验,就别用这个方式。

用 Fluent API 在 OnModelCreating 中配置

DbContext.OnModelCreating 方法里统一设置,完全绕过属性级注解,不参与任何运行时验证:

例如只让 CreatedBy 在数据库强制非空,但不暴露给 UI:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity().Property(o => o.CreatedBy).IsRequired();
    modelBuilder.Entity().Property(u => u.CreatedBy).IsRequired();
}

配合默认值避免迁移失败

如果字段原本允许 NULL,现在要改成 NOT NULL,直接加 IsRequired() 并生成迁移会失败(因已有 NULL 数据)。必须分两步:

这是生产环境改结构的标配操作,漏掉预处理就会报错“无法将列设为 NOT NULL,因为存在 NULL 值”。

小技巧:让非空字段自动填默认值

除了设 IsRequired(),还可以搭配默认值,让数据库兜底:

这样即使应用层没赋值,插入也不会失败,还能保持列非空。

基本上就这些。注解够用就别折腾,要解耦验证和数据库约束就上 Fluent API,改老表记得补数据再锁空值。