Serverless本地调用函数时Mongoose模块引用报错求助

嘿，这个问题我之前帮同事排查过好几次，本质是Mongoose 5.x早期版本和Serverless本地调用的依赖处理逻辑不兼容——哪怕你只是require了Mongoose没实际调用它，Mongoose在初始化阶段就会尝试加载内置的MongoDB驱动模块，而Serverless的本地环境可能没正确解析这些嵌套依赖的路径，或者依赖安装过程中出现了损坏。

下面是几个亲测有效的解决步骤：

1. 重新安装完整依赖 #

首先排除依赖损坏的可能：

• 删除本地的node_modules文件夹和package-lock.json文件
• 执行npm install重新安装所有依赖

rm -rf node_modules package-lock.json
npm install

有时候嵌套依赖（比如Mongoose依赖的mongodb驱动）在安装时会出现路径异常，重新安装能大概率解决这类问题。

2. 调整Serverless的打包配置 #

如果重新安装没用，那可能是Serverless本地调用时没正确包含Mongoose的依赖文件。你可以在serverless.yml里添加package配置，明确包含Mongoose相关的依赖：

package:
  exclude:
    - .git/**
    - .vscode/**
    - README.md
  include:
    - node_modules/mongoose/**
    - node_modules/mongodb/**

这样能确保本地调用时，Serverless会加载这些必要的依赖模块。

3. 升级Mongoose版本 #

你用的Mongoose@5.0.17是2018年的老版本了，存在很多已知的兼容性问题，包括依赖加载的bug。建议升级到5.x系列的稳定后期版本（比如5.13.20），或者直接升级到6.x/7.x版本（注意：高版本可能需要调整少量代码，但如果你只是简单require的话，改动几乎为0）。

npm install mongoose@5.13.20 --save

新版本修复了很多依赖解析的问题，能从根源上避免这类报错。

4. 临时Workaround：手动指定驱动路径（不推荐） #

如果暂时不能升级，可以尝试在requireMongoose之前手动设置驱动路径：

process.env.MONGOOSE_DRIVER_PATH = './node_modules/mongodb/lib/connection'
const mongoose = require('mongoose')

不过这个方法比较hack，只适合临时救急，还是推荐前面的升级或重新安装方案。

补充下为什么只是引入就报错：Mongoose在被require的时候就会执行初始化逻辑，包括加载对应的MongoDB驱动模块，不是等到你调用它的connect方法才执行，所以哪怕你没实际使用Mongoose的功能，只要引入了就会触发这个加载过程。

内容的提问来源于stack exchange，提问作者Taylor Austin