Entity Framework Code First迁移中默认值设置无效问题咨询

我之前踩过一模一样的坑！结合官方文档和实际排查经验，帮你梳理下几个最可能的原因和解决办法：

一、先搞清楚两个参数的核心区别（别用错场景） #

你提到的MSDN说明没错，但很多人会搞混适用场景：

• defaultValue：是C#端的常量值，EF会把这个值直接硬编码到迁移脚本里，适合固定不变的默认值（比如false、0、"unknown"）。
• defaultValueSql：是数据库端的SQL表达式，EF会直接把这段SQL写到数据库列的默认值绑定里，适合动态值（比如当前时间GETDATE()、数据库函数NEWID()）。

举个反例：如果你用defaultValue = DateTime.Now，EF会把你执行Add-Migration那一刻的时间硬编码成固定值，而不是让数据库自动生成当前时间——这时候必须用defaultValueSql = "GETDATE()"。

二、检查迁移脚本是否正确生成并执行 #

这是最常见的问题！很多人配置了属性但忘了走迁移流程：

1. 生成迁移脚本：在Package Manager Console里执行Add-Migration AddDefaultColumnValues（名字随便起，能看懂就行）。
2. 检查脚本内容：打开生成的迁移类，确认Up()方法里的AddColumn/AlterColumn语句包含了defaultValue或defaultValueSql参数，比如：

   public override void Up()
   {
       AddColumn("dbo.Products", "IsInStock", c => c.Boolean(nullable: false, defaultValue: true));
       AddColumn("dbo.Products", "CreatedAt", c => c.DateTime(nullable: false, defaultValueSql: "GETDATE()"));
   }
   

3. 执行迁移：执行Update-Database把脚本应用到数据库。

如果生成的脚本里没默认值，可能是EF没识别到你的配置——这时候可以手动修改脚本加上参数，或者检查你的DataAnnotations/Fluent API写法是否正确。

三、默认值只对新数据生效！ #

别指望设置默认值后，数据库里已有的旧行会自动填充默认值！默认值是针对新插入的记录生效的。如果要给现有数据补默认值，需要在迁移脚本的Up()方法里加手动更新的SQL：

public override void Up()
{
    // 先加列并设置默认值
    AddColumn("dbo.Products", "IsInStock", c => c.Boolean(nullable: false, defaultValue: true));
    // 给旧数据补值
    Sql("UPDATE dbo.Products SET IsInStock = 1 WHERE IsInStock IS NULL;");
}

四、注意配置方式的优先级和正确性 #

DataAnnotations写法示例 #

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    
    // 常量默认值用DefaultValue
    [Column(DefaultValue = "true")]
    public bool IsInStock { get; set; }
    
    // 数据库表达式用DefaultValueSql
    [Column(DefaultValueSql = "GETDATE()")]
    public DateTime CreatedAt { get; set; }
}

Fluent API写法示例（EF Core更直观） #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Product>()
        .Property(p => p.IsInStock)
        .HasDefaultValue(true); // 对应defaultValue
        
    modelBuilder.Entity<Product>()
        .Property(p => p.CreatedAt)
        .HasDefaultValueSql("GETDATE()"); // 对应defaultValueSql
}

如果同时用了DataAnnotations和Fluent API，Fluent API的配置会覆盖DataAnnotations，别搞混了。

最后验证 #

迁移执行完后，直接去数据库里看表设计：找到对应的列，检查「默认值或绑定」字段是否正确设置了值或SQL表达式——如果这里是空的，说明迁移没生效，回去检查脚本和执行步骤。

内容的提问来源于stack exchange，提问作者ˈvɔlə