如何在NestJS中定义PostgreSQL数据库的列顺序？

问题场景 #

我在NestJS应用中定义了如下实体：

@Entity({ name: DB_TABLE_NAME_TEST })
export class TestEntity {
  @PrimaryGeneratedColumn('uuid')
  id: string;

  @Exclude({ toPlainOnly: true }) //hide from response objects
  @ManyToOne(() => AccountEntity, (acct) => acct.id)
  @JoinColumn()
  account: string;

  @Column()
  description: string;

  @Column()
  testerName: string;

  @Column()
  testerEmail: string;

  @Column({ type: 'jsonb', array: false, default: () => "'[]'", nullable: false })
  @Type(() => Array<ITestEvent>)
  eventList: Array<ITestEvent>;

  @Column({ type: 'jsonb', array: false, default: () => "'[]'", nullable: false })
  @Type(() => Array<QuestionLibraryEntity>)
  questionLibraries: Array<QuestionLibraryEntity>;
}

但创建PostgreSQL表后，pgAdmin中显示的列顺序与实体定义不一致：

由于两个jsonb列的数据可能很长，导致accountId列被挤出屏幕，我希望它能像实体定义的那样紧邻id列，请问如何指定列顺序？

可行方案 #

1. 利用TypeORM 0.3+的position属性（最简方案） #

TypeORM 0.3及以上版本为@Column装饰器添加了position参数，可直接指定列的排序位置（从1开始计数）。针对你的account字段，修改如下：

@Exclude({ toPlainOnly: true })
@ManyToOne(() => AccountEntity, (acct) => acct.id)
@JoinColumn({ name: 'accountId' }) // 显式指定列名，避免歧义
@Column({ position: 2 }) // 设定在id（position:1）之后
account: string;

其他字段可按需设置position值，确保列顺序完全符合预期。

2. 手动编写迁移脚本（完全可控） #

如果项目使用TypeORM迁移功能，可直接在迁移文件中按期望顺序定义列，彻底掌控表结构：

export class CreateTestTable1620000000000 implements MigrationInterface {
  public async up(queryRunner: QueryRunner): Promise<void> {
    await queryRunner.createTable(
      new Table({
        name: DB_TABLE_NAME_TEST,
        columns: [
          {
            name: 'id',
            type: 'uuid',
            isPrimary: true,
            generationStrategy: 'uuid',
            default: 'uuid_generate_v4()',
          },
          {
            name: 'accountId',
            type: 'uuid',
            isNullable: false,
          },
          {
            name: 'description',
            type: 'varchar',
          },
          {
            name: 'testerName',
            type: 'varchar',
          },
          {
            name: 'testerEmail',
            type: 'varchar',
          },
          {
            name: 'eventList',
            type: 'jsonb',
            default: "'[]'",
            isNullable: false,
          },
          {
            name: 'questionLibraries',
            type: 'jsonb',
            default: "'[]'",
            isNullable: false,
          },
        ],
        foreignKeys: [
          {
            columnNames: ['accountId'],
            referencedColumnNames: ['id'],
            referencedTableName: 'account',
            onDelete: 'CASCADE',
          },
        ],
      }),
      true,
    );
  }

  public async down(queryRunner: QueryRunner): Promise<void> {
    await queryRunner.dropTable(DB_TABLE_NAME_TEST);
  }
}

3. 重要提示 #

早期TypeORM版本不会保证实体字段的定义顺序与数据库列顺序一致——框架内部可能会重新排序字段（比如优先处理主键、再处理普通列、最后处理关联列）。因此不要依赖实体字段顺序来控制列顺序，必须使用上述显式配置方式。

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