Mongoose：如何将MongoDB文档的字符串数组字段更新为引用对象数组？

问题根源 #

Mongoose的Schema会严格校验字段类型，旧文档中fruitsInBasket存储为字符串数组，而新Schema定义该字段为ObjectId数组，类型不匹配时Mongoose会自动过滤掉该字段，导致查询返回结果中无法看到它。

迁移步骤 #

1. 绕过Mongoose Schema，用原生驱动查询完整数据 #

Mongoose的模型会过滤不匹配类型的字段，所以直接使用MongoDB原生客户端连接数据库，这样能获取包含字符串数组的fruitsInBasket字段。示例代码：

const { MongoClient } = require('mongodb');

async function migrateBaskets() {
  // 替换为你的数据库连接字符串
  const client = new MongoClient('mongodb://localhost:27017/your-database-name');
  await client.connect();
  const db = client.db();

  // 查询所有Basket文档，包含未被Mongoose过滤的字段
  const allBaskets = await db.collection('baskets').find({}).toArray();

2. 匹配Fruit集合并更新Basket文档 #

遍历每个Basket文档，将旧的字符串水果标识（根据实际业务调整匹配条件，比如旧字符串是水果名称、编码等）对应到Fruit集合的ObjectId，再更新Basket的fruitsInBasket字段：

for (const basket of allBaskets) {
    // 跳过无水果数据的文档
    if (!basket.fruitsInBasket || basket.fruitsInBasket.length === 0) continue;

    // 假设旧字符串是Fruit集合的name字段，根据实际情况修改查询条件
    const matchedFruits = await db.collection('fruits').find({
      name: { $in: basket.fruitsInBasket }
    }).toArray();

    // 提取匹配到的Fruit的ObjectId数组
    const fruitObjectIds = matchedFruits.map(fruit => fruit._id);

    // 更新当前Basket文档的fruitsInBasket字段
    await db.collection('baskets').updateOne(
      { _id: basket._id },
      { $set: { fruitsInBasket: fruitObjectIds } }
    );
  }

  await client.close();
  console.log('Basket数据迁移完成');
}

// 执行迁移脚本
migrateBaskets().catch(err => console.error('迁移失败:', err));

3. 验证迁移结果 #

迁移完成后，使用新的Mongoose Basket模型查询数据，fruitsInBasket字段会正常返回ObjectId数组，且可以通过populate('fruitsInBasket')关联查询对应的Fruit详情。

可选：临时兼容Schema（用于过渡） #

如果需要临时处理旧数据而不立刻迁移，可以修改Schema为混合类型，同时兼容字符串和ObjectId数组：

const basketSchema = mongoose.Schema({
  user: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'User',
    required: [true, 'Please provide valid user'],
  },
  fruitsInBasket: {
    type: mongoose.Schema.Types.Mixed, // 临时兼容两种类型
    ref: 'Fruit',
  }
});

完成数据迁移后，再将Schema改回原本的ObjectId数组定义即可。

内容的提问来源于stack exchange，提问作者Romax Rajeev