使用Entity Framework Core保存UserSession时触发CHECK约束冲突的解决方法

问题根源：客户端生成的DateTime.UtcNow和数据库服务器的GETUTCDATE()存在时间差，若客户端系统时间比数据库服务器快，会导致CreatedTime（客户端时间）大于数据库当前UTC时间，触发CHECK约束冲突。

方案1：由数据库自动生成CreatedTime（推荐） #

彻底规避客户端与服务器时间不一致的问题，同时确保数据满足约束：

1. 修改数据库列，设置默认值为GETUTCDATE()：

ALTER TABLE dbo.UserSession
ALTER COLUMN CreatedTime DATETIME NOT NULL CONSTRAINT DF_UserSession_CreatedTime DEFAULT GETUTCDATE();

2. 在EF Core中标记该列为数据库生成：
   • 数据注解方式：

   public class UserSession
   {
       // 其他属性
       [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
       public DateTime CreatedTime { get; set; }
   }
   

   • Fluent API方式（在DbContext的OnModelCreating方法中）：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       modelBuilder.Entity<UserSession>()
           .Property(s => s.CreatedTime)
           .HasDefaultValueSql("GETUTCDATE()")
           .ValueGeneratedOnAdd();
   }
   

3. 代码中不再手动设置CreatedTime：

var newSession = new UserSession
{
    // ... 仅设置其他属性
};
_dbContext.UserSessions.Add(newSession);
await _dbContext.SaveChangesAsync();

方案2：给CHECK约束增加时间缓冲 #

若必须由客户端设置时间，可调整约束允许微小时间差：

-- 先删除旧约束，再创建带缓冲的新约束
ALTER TABLE dbo.UserSession
DROP CONSTRAINT CK__UserSession__CreatedTi__690797E6;

ALTER TABLE dbo.UserSession
ADD CONSTRAINT CK_UserSession_CreatedTime CHECK ([CreatedTime] <= DATEADD(second, 5, GETUTCDATE()));

这里设置了5秒缓冲，可根据实际时间偏差调整秒数。

方案3：从服务器获取时间后赋值 #

让客户端先从数据库获取当前UTC时间，再赋值给CreatedTime，确保时间来源与约束一致：

// 查询服务器当前UTC时间
var serverUtcNow = await _dbContext.Database.SqlQuery<DateTime>("SELECT GETUTCDATE()").FirstAsync();

var newSession = new UserSession
{
    // ...
    CreatedTime = serverUtcNow
};
_dbContext.UserSessions.Add(newSession);
await _dbContext.SaveChangesAsync();

该方式需额外数据库查询，适合对时间精度要求极高且必须客户端赋值的场景。

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