Mongoose是Node.js环境下操作MongoDB的主流ODM库，在实际业务开发中，我们经常需要定义包含多个ObjectId的数组字段，用来实现文档之间的关联关系，比如一篇文章可以关联多个分类标签，一个用户可以拥有多个收藏的商品。
数组类型ObjectId字段的正确定义方式
在Mongoose的Schema定义中，数组类型ObjectId字段的核心是通过Schema.Types.ObjectId来指定元素类型，同时需要配合ref属性指定关联的集合名称，这样后续才能使用populate方法进行关联查询。
基础定义语法
以下是一个标准的数组类型ObjectId字段定义示例，假设我们有一个文章集合，每篇文章可以关联多个标签：
const mongoose = require('mongoose');
const { Schema } = mongoose;
// 定义标签Schema
const tagSchema = new Schema({
name: String,
createTime: { type: Date, default: Date.now }
});
const Tag = mongoose.model('Tag', tagSchema);
// 定义文章Schema，tags字段为数组类型ObjectId
const articleSchema = new Schema({
title: String,
content: String,
// 数组类型ObjectId字段定义，ref指向Tag集合
tags: [{ type: Schema.Types.ObjectId, ref: 'Tag' }],
createTime: { type: Date, default: Date.now }
});
const Article = mongoose.model('Article', articleSchema);
这里需要注意，ref属性的值需要和关联模型的名称保持一致，也就是mongoose.model的第一个参数，这样Mongoose才能正确找到对应的集合进行关联查询。
带默认值的数组ObjectId字段
如果希望数组类型的ObjectId字段默认值为空数组，可以在定义时添加default配置：
const articleSchema = new Schema({
title: String,
content: String,
// 默认值为空数组的ObjectId数组
tags: [{ type: Schema.Types.ObjectId, ref: 'Tag', default: [] }],
createTime: { type: Date, default: Date.now }
});
数组类型ObjectId字段的常见应用
多对多关系建模
数组类型ObjectId字段最常见的用途是实现多对多关系，比如用户和角色的关系，一个用户可以拥有多个角色，一个角色也可以分配给多个用户：
// 角色Schema
const roleSchema = new Schema({
roleName: String,
permissions: [String]
});
const Role = mongoose.model('Role', roleSchema);
// 用户Schema，roles字段存储多个角色ObjectId
const userSchema = new Schema({
username: String,
password: String,
roles: [{ type: Schema.Types.ObjectId, ref: 'Role' }]
});
const User = mongoose.model('User', userSchema);
关联查询操作
定义好数组类型ObjectId字段后，可以使用populate方法将ObjectId替换为对应的完整文档数据：
// 查询文章并关联查询对应的标签信息
async function getArticleWithTags(articleId) {
const article = await Article.findById(articleId).populate('tags');
return article;
}
如果需要指定关联查询返回的字段，可以给populate传递配置参数：
// 只返回标签的name字段，不返回_id和createTime
async function getArticleWithTagNames(articleId) {
const article = await Article.findById(articleId).populate({
path: 'tags',
select: 'name -_id' // 选择name字段，排除_id字段
});
return article;
}
数组元素的增删改操作
对数组类型ObjectId字段的元素进行操作，和普通数组的操作逻辑一致，以下是常见的操作示例：
// 给文章添加一个标签ObjectId
async function addTagToArticle(articleId, tagId) {
await Article.findByIdAndUpdate(articleId, {
$push: { tags: tagId }
});
}
// 从文章中移除一个标签ObjectId
async function removeTagFromArticle(articleId, tagId) {
await Article.findByIdAndUpdate(articleId, {
$pull: { tags: tagId }
});
}
// 替换文章的所有标签
async function updateArticleTags(articleId, newTagIds) {
await Article.findByIdAndUpdate(articleId, {
tags: newTagIds
});
}
使用注意事项
- 数组中的ObjectId必须是有效的MongoDB ObjectId，否则存储或者查询时会出现错误，如果需要校验，可以添加自定义的校验逻辑。
- 如果关联的文档被删除，数组中的ObjectId不会自动移除，需要手动处理，避免存在无效的引用。
- 当数组中的ObjectId数量很多时，使用
populate查询可能会影响性能，此时可以考虑分页查询或者只存储必要的关联信息。 - 不要将数组类型ObjectId字段和普通的ObjectId字段混淆，普通ObjectId字段定义不需要数组包裹，比如
author: { type: Schema.Types.ObjectId, ref: 'User' }是单个关联，而数组类型是[{ type: Schema.Types.ObjectId, ref: 'Tag' }]。
常见问题解答
定义时忘记加ref属性会怎么样
如果定义数组类型ObjectId字段时没有加ref属性，那么populate方法无法生效，查询到的数组元素只会是原始的ObjectId字符串，不会替换为对应的文档数据。
可以直接往数组里存普通字符串吗
不建议这么做，因为数组类型指定为Schema.Types.ObjectId后，Mongoose会自动尝试将存入的值转换为ObjectId，如果存入普通字符串且不是有效的ObjectId格式，会直接抛出类型错误。