如何在TypeORM与Node.js中用UUID替代MongoDB模型默认ObjectId？

原方案失效原因 #

你的代码存在两个核心问题：

1. MongoDB默认主键字段为_id，直接定义id字段会导致TypeORM生成额外字段，而非替换默认的ObjectId主键
2. 构造函数生成UUID的方式在TypeORM处理Mongo实体时不可靠——从数据库加载实体实例时也会触发构造函数，可能覆盖已有ID

修正后的实现步骤 #

• 安装依赖：确保已安装uuid及TypeScript类型包

npm install uuid
npm install -D @types/uuid

• 修改实体定义：
  使用@BeforeInsert钩子在插入前生成UUID，同时将主键映射到MongoDB默认的_id字段：

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

@Entity("ChargingPoint")
export class Sample {
  @PrimaryColumn({ type: "string", name: "_id" })
  id!: string;

  // 示例其他字段
  @Column()
  chargingName!: string;

  @BeforeInsert()
  generateUuid() {
    this.id = uuidv4();
  }
}

关键说明 #

• name: "_id"：强制映射到MongoDB的默认主键字段，避免生成冗余的id列
• @BeforeInsert钩子：仅在实体首次插入数据库时生成UUID，不会影响从数据库加载的已有实体
• 类型指定为string：UUID本质是字符串，MongoDB支持将字符串作为_id存储

额外注意事项 #

如果集合中已有旧数据，需要手动迁移现有_id（ObjectId类型）为UUID格式，避免新旧数据主键类型不一致导致查询异常。

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