Mongoose 中 Lookup 连接集合时命名问题的正确处理

本文旨在帮助开发者解决在使用 Mongoose 的 $lookup 操作符连接集合时遇到的命名问题。核心在于理解 Mongoose 模型名称、引用名称以及数据库实际集合名称之间的关系，确保 $lookup 操作能够正确匹配并返回所需数据。

在使用 Mongoose 进行数据聚合时，$lookup 操作符允许你连接不同的集合，从而实现更复杂的数据查询。然而，在配置 $lookup 操作符时，一个常见的错误是集合名称的设置不正确，导致连接失败。本文将深入探讨如何正确命名连接的集合，并提供清晰的指导。

理解 Mongoose 中的命名规则

在 Mongoose 中，集合的命名涉及到以下几个关键概念：

1. 模型名称 (Model Name): 这是你在 mongoose.model() 函数中定义的名称。例如：

   const recurringSchema = new mongoose.Schema({ /* ... */ });
   mongoose.model('ExpenseRecurring', recurringSchema);

   登录后复制

   在这个例子中，模型名称是 ExpenseRecurring。

2. 引用名称 (Reference Name): 这是你在 Schema 中使用 ref 属性时指定的名称。例如：

   const transactionSchema = new mongoose.Schema({
     expenseRecurring: {
       type: mongoose.Schema.Types.ObjectId,
       ref: 'ExpenseRecurring', // 引用名称
       required: false,
     },
   });

   登录后复制

   在这个例子中，引用名称也是 ExpenseRecurring。引用名称必须与模型名称完全一致。

3. 集合名称 (Collection Name): 这是 MongoDB 数据库中实际存储数据的集合的名称。Mongoose 默认会将模型名称转换为小写，并添加一个 "s" 作为后缀。所以，如果你的模型名称是 ExpenseRecurring，那么默认的集合名称将会是 expenserecurrings。

解决 $lookup 中的命名问题

当你使用 $lookup 操作符时，from 字段需要指定数据库中实际的集合名称。以下是一个 $lookup 操作的示例：

钉钉 AI 助理

钉钉AI助理汇集了钉钉AI产品能力，帮助企业迈入智能新时代。

21

查看详情

const aggregate = [
  {
    $lookup: {
      from: 'expenserecurrings', // 集合名称
      localField: 'expenseRecurring',
      foreignField: '_id',
      as: 'expenseRecurring',
    },
  },
  {
    $unwind: '$expenseRecurring',
  },
  {
    $match: { /* ...filter */ },
  },
];

要确保 $lookup 操作成功，你需要检查以下两点：

1. 模型名称和引用名称是否一致： 确保你在 mongoose.model() 中定义的模型名称与你在 Schema 中 ref 属性中使用的引用名称完全一致。如果两者不一致，Mongoose 将无法正确建立引用关系。

2. from 字段是否指定了正确的集合名称： from 字段必须指定 MongoDB 数据库中实际的集合名称。通常，这是模型名称的小写形式加上 "s" 后缀。但是，你也可以在定义 Schema 时显式指定集合名称，例如：

   const recurringSchema = new mongoose.Schema({ /* ... */ }, { collection: 'my_expense_recurrings' });
   mongoose.model('ExpenseRecurring', recurringSchema);

   登录后复制

   在这种情况下，from 字段应该设置为 my_expense_recurrings。

示例代码

假设我们有以下模型：

const mongoose = require('mongoose');

const recurringSchema = new mongoose.Schema({
  name: String
}, { collection: 'expense_recurrings' }); // 显式指定集合名称

const ExpenseRecurring = mongoose.model('ExpenseRecurring', recurringSchema);

const transactionSchema = new mongoose.Schema({
  expenseRecurring: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'ExpenseRecurring',
    required: false,
  }
});

const Transaction = mongoose.model('Transaction', transactionSchema);

// 聚合查询
async function getTransactions() {
  try {
    const aggregate = [
      {
        $lookup: {
          from: 'expense_recurrings', // 使用显式指定的集合名称
          localField: 'expenseRecurring',
          foreignField: '_id',
          as: 'expenseRecurring',
        },
      },
      {
        $unwind: {
          path: '$expenseRecurring',
          preserveNullAndEmptyArrays: true // 处理expenseRecurring为空的情况
        }
      }
    ];

    const transactions = await Transaction.aggregate(aggregate);
    console.log(transactions);
  } catch (error) {
    console.error(error);
  }
}

getTransactions();

注意事项

• 始终使用小写字母和下划线来命名集合，这是一种常见的最佳实践。
• 在生产环境中，强烈建议显式指定集合名称，以避免 Mongoose 默认命名规则带来的潜在问题。
• 使用 preserveNullAndEmptyArrays: true 处理 $unwind 操作中可能为空的数组，防止数据丢失。

总结

正确处理 Mongoose 中 $lookup 操作符的命名问题，需要理解模型名称、引用名称和集合名称之间的关系。通过确保模型名称和引用名称一致，并正确设置 from 字段，你可以避免连接失败的问题，并成功地实现复杂的数据聚合查询。记住，仔细检查集合名称是解决此类问题的关键。

以上就是Mongoose 中 Lookup 连接集合时命名问题的正确处理的详细内容，更多请关注php中文网其它相关文章！