NestJS+TypeORM使用UUID主键保存时id字段为空报错如何解决

错误的核心原因是你在创建实体对象时手动指定了id: null，@PrimaryGeneratedColumn('uuid')的自动生成逻辑只会在你未主动传递id字段时触发，你主动传了null值，TypeORM就会将null作为id值提交到数据库，触发非空约束报错。

修复方法 #

1. 移除创建对象时的id字段赋值 #

修改服务层的create方法，创建实体时不要传递id属性，两种常用写法可选：

// 写法1：直接传递不带id的对象保存
create(): Promise<Job> {
  return this.jobRepository.save({
    name: 'Job Name',
    // 其他业务字段，不要包含id
  });
}

// 写法2（更推荐）：用repository的create方法实例化实体，避免字段校验问题
create(): Promise<Job> {
  const job = this.jobRepository.create({
    name: 'Job Name',
    // 其他业务字段
  });
  return this.jobRepository.save(job);
}

2. 排查数据库配置和迁移问题 #

如果修改后还是报错，按以下顺序检查：

• 确认PostgreSQL已启用uuid-ossp扩展：执行SQLCREATE EXTENSION IF NOT EXISTS "uuid-ossp";，否则数据库无法自动生成uuid值
• 确认实体修改后已生成并执行了最新的迁移，数据库表的id列默认值已设置为uuid_generate_v4()
• 若使用自动同步（synchronize: true，仅推荐开发环境用），重启服务让TypeORM自动更新表结构

3. 可选排查项 #

如果上述操作都无效，检查TypeORM版本，部分旧版本存在uuid自动生成的兼容bug，升级到最新稳定版即可解决。

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