EF Core使用HasDefaultValueSql()时向带时区时间戳存入错误数据

问题重现 #

你在配置实体时间默认值时使用以下代码：

modelBuilder.Entity(entityType.ClrType)
            .Property("Created")
            .IsRequired()
            .HasDefaultValueSql("timezone('utc', NOW())");

出现以下问题：

• 通过EF Core插入实体时，存入的UTC时间比预期少6小时（你所在时区为+3，预期UTC时间为当前时间减3小时，实际减6小时）；
• 通过PgAdmin插入时，UTC时间存入正常；
• 使用.HasDefaultValue(DateTime.UtcNow)时，值仅在迁移创建时计算，无法动态生成默认值；
• 使用.HasDefaultValueSql("NOW()")时，EF Core插入的时间看似UTC，但PgAdmin插入的是本地时间。

原因分析 #

1. EF Core未触发数据库默认值：
   你未在配置中添加ValueGeneratedOnAdd()，导致EF Core认为Created属性需要由应用程序赋值，而非数据库生成。此时EF会自动为该属性生成本地时间（DateTime.Now），而非依赖数据库的默认值SQL。

2. 双重时区转换：
   若数据库列类型为timestamp with time zone，EF Core会将生成的本地时间（+3时区）转换为UTC时间（减3小时）存入；而你预期的是数据库直接生成UTC时间（即数据库本地时间减3小时）。两者叠加就导致存入的时间比预期再减3小时，总共少6小时。

3. NOW()的行为差异：

   • PostgreSQL中NOW()返回数据库服务器的本地时间；
   • 当使用.HasDefaultValueSql("NOW()")但未配置ValueGeneratedOnAdd()时，EF Core仍会自动传值，此时你看到的“UTC时间”是EF转换后的结果，而非数据库默认值；而PgAdmin插入时无传值，直接使用NOW()存入本地时间。

解决方案 #

方案1：让数据库生成UTC时间（推荐） #

修改实体配置，添加ValueGeneratedOnAdd()告诉EF Core该值由数据库在插入时生成，同时确保默认值SQL正确：

modelBuilder.Entity(entityType.ClrType)
    .Property("Created")
    .IsRequired()
    .HasDefaultValueSql("timezone('utc', NOW())") // 或等价的 CURRENT_TIMESTAMP AT TIME ZONE 'UTC'
    .ValueGeneratedOnAdd(); // 关键配置：启用数据库生成值

同时，确保EF Core对时间类型的映射正确，避免读取时的时区偏差：
在DbContext的OnConfiguring方法中添加：

optionsBuilder.UseNpgsql(connectionString, options =>
{
    options.UseDateTimeKind(DateTimeKind.Utc); // 指定所有DateTime类型按UTC处理
});

方案2：使用DateTimeOffset类型（更严谨） #

将实体的Created属性改为DateTimeOffset类型，EF Core会自动与PostgreSQL的timestamp with time zone列映射，无需手动处理时区：

// 实体类
public DateTimeOffset Created { get; set; }

// 配置
modelBuilder.Entity(entityType.ClrType)
    .Property("Created")
    .IsRequired()
    .HasDefaultValueSql("CURRENT_TIMESTAMP") // CURRENT_TIMESTAMP 返回带时区的当前时间
    .ValueGeneratedOnAdd();

这种方式无需额外配置时区，EF Core会自动处理UTC转换。

方案3：禁用EF自动生成时间值 #

如果需要完全由应用程序控制时间值，可在插入实体时手动赋值DateTime.UtcNow，并移除数据库默认值配置：

// 实体配置
modelBuilder.Entity(entityType.ClrType)
    .Property("Created")
    .IsRequired();

// 插入时赋值
var entity = new YourEntity
{
    Created = DateTime.UtcNow,
    // 其他属性
};
dbContext.YourEntities.Add(entity);
await dbContext.SaveChangesAsync();

补充说明 #

• PostgreSQL中timezone('utc', NOW())和CURRENT_TIMESTAMP AT TIME ZONE 'UTC'效果完全一致，后者可读性更强；
• 若数据库列类型为timestamp without time zone，建议统一使用UTC时间存储，避免时区混淆；
• 迁移后需确保数据库列的默认值已正确生成，可通过PgAdmin查看表结构确认。

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