如何为MongoDB的TypeORM定义分离式Schema？索引报错求解决方案

问题原因 #

TypeORM在生成MongoDB索引配置时，自动添加了已被MongoDB废弃的background: null参数，而MongoDB 6.0不允许将null转换为布尔值，导致插入数据时抛出错误。

具体解决方法 #

• 升级TypeORM到最新稳定版
  旧版本TypeORM存在MongoDB索引参数的兼容性问题，升级到0.3.x及以上版本后，框架会自动移除废弃的background参数，不再生成background: null的无效配置。执行命令升级：

  npm install typeorm@latest
  # 或使用yarn
  yarn add typeorm@latest
  

• 手动覆盖索引配置
  如果暂时无法升级版本，可以在BaseEntitySchema的indices配置中，显式指定background为布尔值（即使MongoDB不再使用该参数，也能避免TypeORM生成null值）：

  const BaseEntitySchema = new EntitySchema({
    name: "BaseEntity",
    columns: {
      // 你的基础字段配置
    },
    indices: [
      {
        name: "IDX_ID",
        unique: true,
        sparse: false,
        background: false // 显式设置布尔值，避免生成null
      }
    ]
  });
  

• 切换到装饰器式实体定义
  放弃分离式Schema定义，改用TypeORM的装饰器语法，这种方式的索引生成逻辑更稳定，不易出现此类兼容性问题：

  import { Entity, PrimaryGeneratedColumn, Column } from "typeorm";
  
  @Entity()
  export abstract class BaseEntity {
    @PrimaryGeneratedColumn()
    _id: string;
  
    // 其他基础字段
  }
  
  @Entity()
  export class UserType extends BaseEntity {
    @Column()
    typeName: string;
  
    // 其他字段
  }
  

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