Node.js ES6下Mongoose实现Channel订阅数组增删逻辑及报错解决
问题原因梳理
- 操作符拼写错误:Mongoose 移除数组匹配元素的操作符是
$pull,代码里误写为$poll,属于无法识别的非法操作符 - 判断逻辑完全失效:
Channel.find()方法的返回值永远是数组结构,哪怕没有匹配到任何频道,返回的也是空数组[],永远不会严格等于undefined,导致分支判断完全不符合预期 - 类型定义冲突:在 Mongoose Channel 模型里手动定义了一个 ObjectId 类型的
id字段,直接覆盖了 Mongoose 默认生成的虚拟id字段(自动映射_id的十六进制字符串值),引发类型推断异常;加上修改模型定义后如果没有重启进程,Mongoose 的内置模型缓存会复用旧的 Schema 结构,把subscribers数组的元素类型从预期的String识别为关联的 ObjectId 类型。当传入长度不足24位十六进制格式的用户ID"1234"时,Mongoose 会强制将其转为 ObjectId 格式,最终触发Cast to ObjectId failed报错 - 参数映射错误:函数需要传入
channel_path作为匹配查询条件,但实际调用时传的键是channel_name,无法匹配到正确的频道文档
修正方案
1. 调整 Mongoose 模型定义
删掉冗余的手动id字段,明确subscribers为纯字符串数组,从根源上避免类型推断混乱:
import mongoose from 'mongoose'; export const Channel = mongoose.model('Channel', { name: { type: String, required: true }, path: { type: String, required: true, unique: true }, subscribers: { type: [String], default: [] // 预设空数组,避免后续处理null值 } });
注:Mongoose 默认会为每个文档自动生成
_id(ObjectId 类型),并提供对应的虚拟字段id(返回_id的十六进制字符串),完全不需要手动定义同名字段。修改模型定义后需要重启 Node 服务,清除 Mongoose 的模型缓存。
2. 重写切换订阅状态的业务逻辑
不需要额外发起一次查询做存在性判断,利用 Mongoose 的原子操作实现无副作用的「存在则移除、不存在则追加」逻辑,同时避免并发场景下的数据不一致问题:
async function updateChannelSubscriber(channelPath, userId) { // 先执行移除操作,拿到更新前的频道原始文档 const oldChannel = await Channel.findOneAndUpdate( { path: channelPath }, { $pull: { subscribers: userId } }, { new: false } // 返回更新前的旧文档 ); // 频道不存在的异常拦截 if (!oldChannel) { throw new Error('对应路径的频道不存在'); } // 判断旧文档中是否存在目标用户 const hadSubscribed = oldChannel.subscribers.includes(userId); // 如果之前已订阅,本次pull操作已经完成移除,直接返回结果 if (hadSubscribed) { return { isSubscribed: false, subscribers: oldChannel.subscribers.filter(id => id !== userId) }; } // 如果之前未订阅,将用户追加到订阅数组(用$addToSet避免重复添加相同元素) const newChannel = await Channel.findOneAndUpdate( { path: channelPath }, { $addToSet: { subscribers: userId } }, { new: true } ); return { isSubscribed: true, subscribers: newChannel.subscribers }; }
调用时注意映射正确的参数:将传入的
channel_name值作为channelPath参数传入函数即可。
优化说明
- 全程使用原子数据库操作,不需要单独发起查询做存在性判断,减少数据库往返的同时,避免并发场景下的判断不一致问题
- 使用
$addToSet替代$push,从数据库层面避免重复添加相同的用户ID - 显式处理频道不存在的异常场景,避免无意义的空值操作
内容的提问来源于stack exchange,提问作者IsaIkari
相关产品推荐
相关产品推荐

