Npgsql EF Core并发令牌属性被纳入迁移的问题咨询

核心结论：别用Ignore或[NotMapped]，这俩会直接废掉并发控制功能。问题出在你没明确告诉EF Core：Version属性对应的是PostgreSQL已存在的xmin系统列，无需迁移创建。 #

正确配置步骤： #

1. 修正实体注解：给Version属性添加[Column("xmin")]，明确映射到PostgreSQL的系统列：

[Table("users")]
public class User
{
    [Key]
    [Column("id")]
    public long Id { get; set; }

    [Column("name")]
    public required string Name { get; set; }

    [Column("password_hash")]
    public required string PasswordHash { get; set; }

    /// <remarks>
    /// Maps to PostgreSQL xmin system column for optimistic concurrency control.
    /// </remarks>
    [Timestamp]
    [Column("xmin")] // 关键：指定列名为xmin
    public uint Version { get; set; }
}

2. Fluent API补充配置：在你的DbContext的OnModelCreating方法中，添加以下配置，告诉EF Core这个列是数据库生成的并发令牌，且不需要迁移创建：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<User>()
        .Property(u => u.Version)
        .HasColumnType("xid") // 匹配PostgreSQL xmin的类型
        .IsConcurrencyToken() // 标记为并发令牌
        .ValueGeneratedOnAddOrUpdate() // 每次增改由数据库自动生成值
        .Metadata.SetAnnotation("Relational:ColumnExists", true); // 告诉迁移：该列已存在，无需创建
}

为什么之前会生成迁移代码？ #

EF Core默认会假设实体属性需要对应数据库中自己创建的列。虽然[Timestamp]在Npgsql中会关联xmin类型，但它不会自动识别这是系统自带列——必须通过Relational:ColumnExists注解或Fluent配置明确告知迁移系统，避免尝试创建已存在的xmin列。

为什么不能用Ignore或[NotMapped]？ #

这两个配置会让EF Core完全忽略Version属性：既不会在查询时读取xmin值，也不会在更新/删除时加入并发校验逻辑，等于完全失去了乐观并发控制的作用，绝对不可取。

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