Mongoose 与 MongoDB 版本不一致导致的问题及解决方法

在使用 Mongoose 进行 MongoDB 数据库操作时，由于 Mongoose 和 MongoDB 的版本不一致，可能会出现一些问题。本文将介绍这些问题及对应的解决方法，并给出相应的示例代码。

问题 1：使用过期索引（MongoDB 3.0 以下版本）

如果你的 MongoDB 版本较老（3.0 以下），并且在使用 Mongoose 创建索引时指定了过期时间（TTL），则会出现以下问题：

(node:12520) UnhandledPromiseRejectionWarning: MongoError: no TTL expiry indexed field found ...

这个错误提示其实很明显了，就是没有找到能够过期的索引字段。

解决方法是在创建索引时将 { expireAfterSeconds: n } 作为参数传入，n 为过期时间，例如：

const schema = new mongoose.Schema({
  // ...
  expireAt: { type: Date, expires: '1d' }
});

schema.index({ expireAt: 1 }, { expireAfterSeconds: 0 });

问题 2：使用了废弃方法（MongoDB 4.4 以下版本）

如果你的 MongoDB 版本较老（4.4 以下），并且在使用 Mongoose 时调用了某些废弃的方法，则会出现以下问题：

(node:2721) DeprecationWarning: collection.ensureIndex is deprecated. Use createIndexes instead.

这个错误提示提示你使用了 collection.ensureIndex() 方法，这是一个废弃的方法，新版 MongoDB 已经使用 createIndexes() 方法代替。

解决方法是使用 createIndexes() 方法代替 ensureIndex() 方法，例如：

await Model.createIndexes();

问题 3：使用了 MongoDB 4.2 以上版本的新功能

如果你使用了 MongoDB 4.2 以上版本的一些新功能，但是你的 Mongoose 版本较老，会出现以下问题：

(node:7486) UnhandledPromiseRejectionWarning: MongoError: Unrecognized pipeline stage name: '$setOnInsert'

这个错误提示告诉你使用了不认识的管道阶段 $setOnInsert。

解决方法是使用较新的 Mongoose 或升级 MongoDB 版本。

总结

本文介绍了 Mongoose 与 MongoDB 版本不一致导致的问题及解决方法，涉及到了如下问题：

• 使用过期索引（MongoDB 3.0 以下版本）
• 使用了废弃方法（MongoDB 4.4 以下版本）
• 使用了 MongoDB 4.2 以上版本的新功能

由以上问题可以看出，保持 Mongoose 与 MongoDB 版本的一致性非常重要，尤其是在使用一些新功能时，务必保证 Mongoose 和 MongoDB 版本在足够高的版本上。同时，应该使用最新的 Mongoose API 以避免使用废弃或不再支持的方法。

附：示例代码

下面是在 Mongoose 中解决上述问题的示例代码。

问题 1 示例代码

const schema = new mongoose.Schema({
  // ...
  expireAt: { type: Date, expires: '1d' }
});

schema.index({ expireAt: 1 }, { expireAfterSeconds: 0 });

问题 2 示例代码

await Model.createIndexes();

问题 3 示例代码

const pipeline = [
  { $setOnInsert: { createdAt: new Date() } }
];

await Model.updateOne({ _id }, pipeline, { upsert: true });

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64c2222b83d39b488163eef3