EF Core集成Postgres生成TsVector列报错：引用未知列

核心原因 #

报错本质是PostgreSQL创建生成的tsvector列时，依赖的Name列未被提前定义（迁移脚本列顺序错误），或是你使用的Npgsql/EF Core RC版本存在脚本生成bug。

解决步骤 #

1. 手动修正迁移脚本 #

执行ef migrations add InitialCreate生成迁移文件后，打开迁移文件的Up方法，确保Name列的创建语句在Search列之前：

migrationBuilder.CreateTable(
    name: "ChildLink",
    columns: table => new
    {
        Id = table.Column<int>(type: "integer", nullable: false)
            .Annotation("Npgsql:ValueGenerationStrategy", NpgsqlValueGenerationStrategy.IdentityByDefaultColumn),
        RelativeId = table.Column<int>(type: "integer", nullable: false),
        Name = table.Column<string>(type: "text", nullable: true), // 优先定义Name列
        Search = table.Column<NpgsqlTsVector>(type: "tsvector", nullable: true)
            .Annotation("Npgsql:TsVectorConfig", "english")
            .Annotation("Npgsql:TsVectorProperties", new[] { "Name" })
    },
    constraints: table =>
    {
        table.PrimaryKey("PK_ChildLink", x => x.Id);
        table.ForeignKey(
            name: "FK_ChildLink_Person_RelativeId",
            column: x => x.RelativeId,
            principalTable: "Person",
            principalColumn: "Id",
            onDelete: ReferentialAction.Cascade);
    });

migrationBuilder.CreateIndex(
    name: "IX_ChildLink_Search",
    table: "ChildLink",
    column: "Search")
    .Annotation("Npgsql:IndexMethod", "GIN");

2. 显式指定列创建顺序 #

在OnModelCreating中为列设置顺序，强制Name先于Search被创建：

modelBuilder.Entity<ChildLink>()
    .Property(s => s.Name)
    .HasColumnOrder(3);
modelBuilder.Entity<ChildLink>()
    .Property(s => s.Search)
    .HasColumnOrder(4);

modelBuilder.Entity<ChildLink>()
   .HasGeneratedTsVectorColumn(s => s.Search, "english", link => link.Name)
   .HasIndex(s => s.Search)
   .HasMethod("GIN");

3. 升级至稳定版本 #

你当前使用的是RC（候选发布）版本，这类版本通常存在未修复的bug。建议升级到Npgsql 7.0.0+、EF Core 7.0.0+正式稳定版，多数RC阶段的问题会在正式版中修复。

验证操作 #

调整完成后重新执行ef database update，检查表和索引是否成功创建。

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