使用Typegoose创建Mongoose模型，关联有效ObjectId填充返回Null问题

我之前也碰到过类似的坑，用Typegoose创建Mongoose模型时，关联填充返回null但原生Mongoose能正常工作，大概率是Typegoose的关联配置或者模型初始化环节出了问题，给你几个具体的排查和解决方向：

1. 确保关联字段的ref配置正确 #

Typegoose里不能直接用字符串作为ref值（虽然原生Mongoose可以），因为TypeScript的类型解析问题，必须用箭头函数指向目标类，否则生成的Mongoose模型里的关联引用会出错。

举个正确的示例：

Item.ts #

import { prop, getModelForClass } from '@typegoose/typegoose';
import { Types } from 'mongoose';

export class Item {
  @prop({ required: true })
  name!: string;

  @prop({ required: true })
  price!: number;
}

export const ItemModel = getModelForClass(Item);

User.ts（包含BagItem关联） #

import { prop, getModelForClass, modelOptions } from '@typegoose/typegoose';
import { Types } from 'mongoose';
import { Item } from './Item';

class BagItem {
  // 关键：用箭头函数指向Item类，而非直接写字符串'Item'
  @prop({ ref: () => Item, required: true })
  item!: Types.ObjectId | Item;

  @prop({ required: true })
  quantity!: number;
}

@modelOptions({ schemaOptions: { collection: 'users' } }) // 若有自定义集合名需指定
export class User {
  @prop({ required: true })
  username!: string;

  @prop({ type: () => [BagItem] })
  bag!: BagItem[];
}

export const UserModel = getModelForClass(User);

2. 保证模型在填充前已完成初始化 #

Typegoose的getModelForClass是懒加载逻辑，如果在模型还没被注册到Mongoose的时候就执行查询填充，会导致关联识别失败。

在app.ts里，要确保先完成数据库连接和模型初始化，再执行查询：

import mongoose from 'mongoose';
import { UserModel, ItemModel } from './models';

// 先建立数据库连接
await mongoose.connect('your-db-connection-url');

// 确保模型已完成注册（导入时已执行getModelForClass的话，这里无需额外操作）
// 若担心懒加载问题，可以提前调用一次模型实例
await ItemModel.exists({});

// 执行带填充的查询
const targetUser = await UserModel.findOne({ username: 'testUser' })
  .populate('bag.item'); // 填充路径要和模型字段层级完全匹配

console.log(targetUser?.bag); // 现在应该能正常拿到关联的Item数据了

3. 检查填充路径的正确性 #

确认你在populate里写的路径和模型里的字段结构完全匹配，比如嵌套在bag数组里的item字段，路径必须是bag.item，不能写错层级或者字段名（比如把item写成Item）。

4. 对比原生Mongoose模型的结构 #

如果上面的方法都没用，可以把Typegoose生成的模型和你原生Mongoose的模型打印出来对比：

console.log(UserModel.schema.paths['bag'].schema.paths['item']);

重点看ref值是否和原生模型一致，有没有出现大小写错误或者集合名不匹配的情况（Typegoose默认会把类名转成小写复数作为集合名，如果你原生模型用了自定义集合名，一定要在Typegoose里用@modelOptions指定）。

内容的提问来源于stack exchange，提问作者John Staurt