解决EF Core 6+Npgsql中Instant?类型不被支持的错误

原因 #

EF Core的PostgreSQL提供程序默认不支持NodaTime的Instant类型，而Scaffold-DbContext生成实体时，若项目引用了NodaTime相关依赖，会将数据库时间字段映射为Instant?，进而导致运行时抛出类型不支持的错误。

解决方案 #

方案一：配置EF Core支持NodaTime类型（保留Instant?） #

若想继续使用Instant类型，按以下步骤操作：

1. 安装与.NET 6匹配的Npgsql.EntityFrameworkCore.PostgreSQL.NodaTime NuGet包（选择6.x版本）
2. 在DbContext配置中启用NodaTime支持：
   • 若在DbContext的OnConfiguring方法中配置连接：

     protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
     {
         optionsBuilder.UseNpgsql("你的数据库连接字符串", opt => opt.UseNodaTime());
     }
     

   • 若在Program.cs中注册DbContext：

     builder.Services.AddDbContext<YourDbContext>(options =>
         options.UseNpgsql(builder.Configuration.GetConnectionString("DefaultConnection"),
             opt => opt.UseNodaTime()));
     

方案二：修改实体属性类型为DateTimeOffset?（替换Instant?） #

若无需使用NodaTime的Instant类型，直接修改Account实体的属性类型：

// 原代码
public Instant? Created { get; set; }
public Instant? Modified { get; set; }

// 修改后
public DateTimeOffset? Created { get; set; }
public DateTimeOffset? Modified { get; set; }

DateTimeOffset与PostgreSQL的timestamp with time zone字段原生兼容，无需额外配置即可正常映射。

方案三：忽略该属性（不推荐，仅当字段无需与数据库交互时使用） #

如果这些字段不需要和数据库同步，可以添加[NotMapped]特性：

[NotMapped]
public Instant? Created { get; set; }
[NotMapped]
public Instant? Modified { get; set; }

或者在DbContext的OnModelCreating方法中忽略：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Account>()
        .Ignore(a => a.Created)
        .Ignore(a => a.Modified);
}

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ