请求协助将mongoose-materialized插件移植至Mongoose 5

我刚好处理过类似的Mongoose版本升级问题，核心原因确实是Mongoose 5彻底移除了默认的mpromise，改用原生ES6 Promise（或者你可以指定其他Promise库），旧插件里直接依赖mpromise的API就会抛出"undefined is not a function"错误。下面是一步步的修复方案：

1. 全局替换Promise实现 #

首先在插件的入口文件（或者你的项目配置里），把原来依赖mpromise的代码替换成标准Promise：

// 移除旧的mpromise引入
// const mpromise = require('mpromise');
// mongoose.Promise = mpromise;

// 改用原生Promise（推荐）
mongoose.Promise = global.Promise;

// 如果你偏好bluebird，也可以这样设置
// const bluebird = require('bluebird');
// mongoose.Promise = bluebird;

Mongoose 5会自动使用你指定的Promise库来处理所有异步操作的返回值，不需要手动实例化mpromise了。

2. 重写插件中依赖mpromise的异步方法 #

找到插件里所有手动创建mpromise的代码，比如这种：

// 旧代码：依赖mpromise构造函数
schema.methods.getDescendants = function() {
  return new mongoose.Promise((resolve, reject) => {
    // 复杂的查询逻辑
    this.model('YourModel').find({ path: this.path }, (err, docs) => {
      if (err) return reject(err);
      resolve(docs);
    });
  });
};

改成两种方式之一：

方式一：使用标准Promise构造 #

schema.methods.getDescendants = function() {
  return new Promise((resolve, reject) => {
    this.model('YourModel').find({ path: this.path }, (err, docs) => {
      if (err) return reject(err);
      resolve(docs);
    });
  });
};

方式二：利用Mongoose 5的Query Promise支持（更简洁） #

Mongoose 5的所有查询方法如果不传回调，会直接返回一个thenable的Query对象，你可以直接返回它，或者用.exec()明确获取Promise：

schema.methods.getDescendants = function() {
  // 直接返回Query对象，自动支持Promise链式调用
  return this.model('YourModel').find({ path: this.path });
  
  // 或者用.exec()确保返回标准Promise
  // return this.model('YourModel').find({ path: this.path }).exec();
};

方式三：用async/await重写（可读性最高） #

如果插件的Node.js环境支持ES2017+，强烈推荐用async/await重写异步方法，代码更清晰：

schema.methods.getDescendants = async function() {
  try {
    const descendants = await this.model('YourModel').find({ path: this.path });
    return descendants;
  } catch (err) {
    throw err; // 抛出错误会被Promise的catch捕获
  }
};

3. 修复Schema中的Promise resolver引用 #

如果插件里有直接引用schema.Promise或者this.Promise的地方（这是mpromise时代的写法），全部替换成全局的Promise或者你指定的Promise库：

// 旧代码
const promise = new this.Promise(...)

// 改成
const promise = new Promise(...)

4. 测试关键功能 #

移植完成后，重点测试插件的核心功能：比如节点的添加、删除、查询祖先/后代节点，确保所有异步操作都能正常返回Promise并处理成功/失败状态。

额外提示 #

Mongoose 5还有一些其他的API变化，比如Model.remove()被标记为废弃，建议换成Model.deleteOne()/Model.deleteMany()，如果插件里用到了这些旧方法，最好一并更新，避免后续出现其他兼容性问题。

内容的提问来源于stack exchange，提问作者Enrique Sabalza