Node.js保存数据到MongoDB时触发mongoose-url-slugs未处理拒绝报错
Mongoose数据保存时触发
Cannot read property 'indexOf' of undefined问题排查 根本诱因
- 逐行拆解报错堆栈可以看到,错误触发链路完全在依赖内部闭环:
- 底层抛出点为Mongoose 5.11.8版本的
document.isSelected方法(对应堆栈中mongoose/lib/document.js:2056位置),该方法的核心逻辑是判断传入的字段路径是否属于当前文档的已选中集合,入参为undefined时直接执行undefined.indexOf()就会抛出当前报错。 - 调用该方法的上游节点为
mongoose-url-slugs@1.0.2的保存前置中间件(对应堆栈中插件代码第215行位置),这个旧版本插件在做字段判断时,没有对传入的字段名参数做空值兜底。
- 底层抛出点为Mongoose 5.11.8版本的
- 版本兼容断层是匹配问题出现时间节点的核心原因:
Mongoose从5.11.x迭代开始,移除了isSelected方法对undefined入参的隐式兼容逻辑,而mongoose-url-slugs 1.0.2版本没有同步适配这个内部接口改动。你在1个月前的某次依赖更新中将Mongoose升级到了不兼容的5.11.8版本,在此之前的2个月运行周期里,你使用的是更早的5.10.x版本Mongoose,接口逻辑完全匹配,所以所有保存操作都能正常运行。 - 这个报错和你存储的内容类型(数字、文本等)、业务代码逻辑、Passport配置完全无关:只要走了挂载slug插件的模型保存流程,不管待保存内容是什么,都会在pre中间件阶段走到这个报错点,所以你在自己的业务代码里找不到任何indexOf相关逻辑是正常情况。
可落地解决方案
- 方案1:版本回退(零业务改动最快生效)
执行命令将Mongoose回退到和旧版slug插件完全兼容的5.10.19稳定版:npm install mongoose@5.10.19 --save
安装完成后重启服务,即可恢复和之前2个月完全一致的保存逻辑,不需要修改任何业务代码。 - 方案2:升级slug插件适配当前Mongoose版本
执行命令卸载旧版不兼容的插件,安装已适配新Mongoose接口的最新版slug插件:npm uninstall mongoose-url-slugs && npm install mongoose-url-slugs@latest --save
安装完成后仅需要按照新版插件的初始化规则,调整schema上挂载插件的少量配置代码即可,不需要修改核心业务保存逻辑。 - 方案3:本地打兼容补丁(保留现有依赖版本)
如果不想调整现有依赖的版本号,可以在项目入口文件(比如初始化Mongoose的app.js)中,给isSelected方法增加入参兜底逻辑,直接拦截掉传入undefined的异常场景:
这个补丁不会改变原有正常的字段判断逻辑,也不会影响其他Mongoose功能的运行,适配完成后即可正常执行保存操作。// 放在Mongoose实例初始化完成的代码之后 const nativeIsSelected = mongoose.Document.prototype.isSelected; mongoose.Document.prototype.isSelected = function (fieldPath) { // 空值入参直接返回false,不触发后续的indexOf调用 if (!fieldPath) return false; return nativeIsSelected.call(this, fieldPath); }
内容的提问来源于stack exchange,提问作者Evylent
相关产品推荐
相关产品推荐

