如何填充NestJS Mongoose嵌套Schema记录？巴黎空气质量数据存储异常

核心原因分析 #

你的问题大概率是Schema定义类型错误或查询逻辑遗漏导致的：

• 若你把Pollution定义为引用文档（ref），必须用populate才能拉取完整数据；
• 若你想做嵌套子文档，则不需要populate，但要确保Schema定义正确，且查询时未过滤字段。

解决方案分场景处理 #

场景1：误将子文档定义为引用关系

如果你的Schema是这样写的（引用模式）：

// 错误：用ref定义为引用文档
export const AirQualitySchema = new Schema({
  city: String,
  pollution: { type: Schema.Types.ObjectId, ref: 'Pollution' }, // 引用Pollution集合
  timestamp: Date,
});

这种情况下，查询默认只会返回pollution的_id，必须在查询时调用populate：

// 在Service的查询方法中添加populate
async getParisAirQuality() {
  return this.airQualityModel
    .findOne({ city: 'Paris' })
    .populate('pollution') // 拉取pollution的完整数据
    .exec();
}

场景2：需要嵌套子文档（无需populate）

如果Pollution是AirQuality文档的一部分（嵌套子文档），需直接将子Schema嵌套到主Schema中：

// 1. 先定义Pollution子Schema
export const PollutionSchema = new Schema({
  pm25: Number,
  pm10: Number,
  no2: Number,
  so2: Number,
  // 其他空气质量字段
});

// 2. 主Schema直接嵌套子Schema
export const AirQualitySchema = new Schema({
  city: String,
  pollution: PollutionSchema, // 直接嵌套，不是引用
  timestamp: Date,
});

此时查询无需populate，会自动返回完整的pollution字段数据。

场景3：查询时被投影过滤

如果你的查询语句添加了投影（projection），且未包含pollution字段，也会导致仅返回_id：

// 错误：仅返回city，pollution默认只显示_id
return this.airQualityModel.findOne({ city: 'Paris' }, { city: 1 }).exec();

解决方法：要么去掉投影，要么明确指定返回pollution：

// 正确：返回city和完整的pollution
return this.airQualityModel.findOne({ city: 'Paris' }, { city: 1, pollution: 1 }).exec();

额外排查步骤 #

1. 检查MongoDB数据库中存储的文档，确认pollution字段确实包含子数据（可能存储时因DTO验证或逻辑错误未写入）；
2. 若使用NestJS的@Schema()装饰器，确保子Schema的装饰器配置正确，未禁用字段返回。

内容的提问来源于stack exchange，提问作者Oussama Bouchikhi