Entity Framework Core+PostgreSQL DateTime范围超出问题解决求助

先排查数据库异常数据 #

首先检查目标表中TimeStarted和LastUpdated列的所有数据，确认是否存在超出.NET DateTime范围（1年到9999年）的数值，或者空值导致的映射问题。执行以下SQL查询验证：

SELECT * FROM your_table_name 
WHERE TimeStarted < '0001-01-01' OR TimeStarted > '9999-12-31'
OR LastUpdated < '0001-01-01' OR LastUpdated > '9999-12-31';

如果查到异常数据，先把这些值修正为合法范围内的时间。

修改实体属性为可空DateTime类型 #

.NET的DateTime是值类型，默认不允许空。如果数据库列允许存储空值，EF Core会把PostgreSQL的NULL映射为DateTime.MinValue（0001-01-01），但PostgreSQL的timestamp类型支持的最小值远早于这个时间，一旦读取到这类超范围值就会报错。直接把实体类的时间属性改成可空类型：

public class Entityname
{
    // ...
    public DateTime? TimeStarted { get; set; }
    public DateTime? LastUpdated { get; set; }
}

配置EF Core的时间映射规则 #

如果不想修改实体类型，可以通过上下文配置调整映射逻辑：

• 改用DateTimeOffset类型：
  替换实体属性类型，再在上下文的OnModelCreating中指定映射的数据库列类型：

  public class Entityname
  {
      // ...
      public DateTimeOffset TimeStarted { get; set; }
      public DateTimeOffset LastUpdated { get; set; }
  }
  

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<Entityname>()
          .Property(e => e.TimeStarted)
          .HasColumnType("timestamp(0)");
      modelBuilder.Entity<Entityname>()
          .Property(e => e.LastUpdated)
          .HasColumnType("timestamp(0)");
  }
  

• 添加范围转换逻辑：
  保留DateTime类型，通过转换限制读取值的范围：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<Entityname>()
          .Property(e => e.TimeStarted)
          .HasConversion(
              v => v,
              v => v < DateTime.MinValue ? DateTime.MinValue : v > DateTime.MaxValue ? DateTime.MaxValue : v
          );
      // 对LastUpdated做同样配置
  }
  

更新Npgsql驱动版本 #

旧版本的Npgsql.EntityFrameworkCore.PostgreSQL可能存在timestamp类型映射的bug，确保使用最新稳定版的NuGet包：

Install-Package Npgsql.EntityFrameworkCore.PostgreSQL -Version 最新稳定版本号

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