NestJS+TypeORM+Postgres插入实体失败：dir_id未自动生成

云上老周

2026-8-5

解决TypeORM插入PostgreSQL实体时UUID主键未自动生成的问题

1. 确认实体类主键装饰器配置

确保dir_id字段使用正确的UUID生成配置，TypeORM需要明确指定主键类型为uuid：

import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';

@Entity('directory_dir')
export class Directory {
  // 明确指定UUID生成策略，依赖PostgreSQL的uuid_generate_v4()函数
  @PrimaryGeneratedColumn('uuid')
  dir_id: string;

  // 其他字段定义...
}

如果之前使用@PrimaryGeneratedColumn()无参数，默认是自增整数类型，与UUID列不匹配，会导致TypeORM无法自动生成主键值。

2. 检查Liquibase建表脚本的主键默认值

TypeORM依赖数据库端生成UUID时，必须保证directory_dir表的dir_id列配置了UUID默认生成规则。Liquibase脚本示例：

<createTable tableName="directory_dir">
  <column name="dir_id" type="UUID" defaultValueComputed="uuid_generate_v4()">
    <constraints primaryKey="true" nullable="false"/>
  </column>
  <!-- 其他列配置 -->
</createTable>

对应的SQL语句：

CREATE TABLE directory_dir (
  dir_id UUID PRIMARY KEY DEFAULT uuid_generate_v4() NOT NULL,
  -- 其他字段
);

若表列未设置默认值，TypeORM插入时不会自动填充主键，触发非空约束报错。

3. 可选：手动在实体端生成UUID

如果不想依赖数据库端生成，可直接在实体中使用uuid库手动生成主键：

import { Entity, PrimaryColumn, Column } from 'typeorm';
import { v4 as uuidv4 } from 'uuid';

@Entity('directory_dir')
export class Directory {
  @PrimaryColumn('uuid')
  dir_id: string = uuidv4(); // 实例化时自动生成UUID

  // 其他字段定义...
}

这种方式无需依赖数据库配置，实例化实体或使用repository.create()时会自动赋值dir_id。