Mongoose 之时间戳的使用方法及常见错误场景处理方式-JavaScript中文网-JavaScript教程资源分享门户

如果你是一个前端开发人员，那么你很有可能会使用 Mongoose 这个对象数据模型库来连接 MongoDB 数据库。在 Mongoose 中，有一个非常实用的功能就是时间戳，它可以方便地记录数据的创建时间和修改时间。但是，关于时间戳的使用方法，以及它在某些场合下可能会出现的一些错误，还是有些需要注意的。

本文将详细介绍 Mongoose 中时间戳的使用方法，告诉你它在不同场合下的正确使用方式以及常见的错误场景，也会给出相应的处理方法。

时间戳的基础使用

在 Mongoose 中，为模型添加时间戳功能只需要在定义 Schema 时增加一个 timestamps 选项即可，如下代码所示：

const UserSchema = new mongoose.Schema({
  username: String,
  password: String,
}, {
  timestamps: true,
});

在上述代码中，我们在定义 User 模型的 Schema 时，增加了一个 timestamps 选项，设定为 true，表示自动添加 createdAt 和 updatedAt 字段，并且这两个字段的类型是 Date。这样，当我们使用 User 模型进行数据操作时，便能自动记录数据的创建时间和修改时间了。

为了验证时间戳的使用效果，可以编写如下的测试代码：

// javascriptcn.com 代码示例
const User = mongoose.model('User', UserSchema);

// 创建一条数据
const user = new User({
  username: 'tom',
  password: '123456',
});
user.save((err) => {
  if (err) console.log(err);
});

// 修改这条数据
User.updateOne({ _id: user._id }, { password: '654321' }, (err) => {
  if (err) console.log(err);
});

// 查找这条数据
User.findById(user._id, (err, res) => {
  if (err) console.log(err);
  console.log(`创建时间：${res.createdAt}`);
  console.log(`修改时间：${res.updatedAt}`);
});

在上述测试代码中，我们先创建一条数据，接着修改这条数据，最后查找这条数据，并将其创建时间和修改时间输出。

如果一切正常，测试结果将如下所示：

创建时间：2022-01-01T00:00:00.000Z
修改时间：2022-01-01T00:00:01.000Z

可以看到，这条数据的创建时间和修改时间分别是 2022-01-01T00:00:00.000Z 和 2022-01-01T00:00:01.000Z，符合我们的预期。

错误场景及处理方式

虽然时间戳是非常实用的功能，但在某些场合下，却可能会出现一些错误。下面我们就来看看这些错误可能是什么，以及该如何解决。

误删 timestamps 选项导致时间戳失效

在上述代码中，我们为 User 模型增加了 timestamps 选项，这样便可以自动记录数据的创建时间和修改时间了。但是，如果我们在某个时候，误删了这个选项，那么时间戳就会失效。

举个例子，如果我们将 User 模型的 Schema 修改为如下代码：

const UserSchema = new mongoose.Schema({
  username: String,
  password: String,
});

这时，我们再运行测试代码，查找这条数据时所输出的创建时间和修改时间就都是 null 了。

为了避免这种问题，我们可以在 Schema 定义时，将 timestamps 规定为必须的选项，在没有指定的情况下，不允许将其删除：

const UserSchema = new mongoose.Schema({
  username: String,
  password: String,
}, {
  timestamps: true,
  strict: 'throw', // 如果 Schema 中没有定义的字段，会抛出错误
});

在上述代码中，我们增加了一个 strict 选项，设定为 'throw'，表示如果在 Schema 定义时缺少某些必须的字段，则直接抛出错误。这样就能够有效避免误删 timestamps 选项的问题。

时间格式问题导致时间戳无法正确显示

在 Mongoose 中，时间戳会使用 UTC 格式来保存时间数据。但是，如果我们用了一些错误的时间格式，那么时间戳就无法正确显示了。

举个例子，假设我们向 User 模型中插入了一条数据，但日期格式是使用中文的年月日，如下所示：

const user = new User({
  username: 'tom',
  password: '123456',
  createdAt: '2022年01月01日 00:00:00',
});
user.save((err) => {
  if (err) console.log(err);
});

此时，我们再去查找这条数据，就会发现创建时间和修改时间都是 null。

为了避免这种问题，我们可以在使用时间戳时，规定时间格式统一使用 UTC 时间格式。

数据库存在 UTC 时间格式与本地时间格式的时差问题

在 Mongoose 的时间戳功能中，使用的是 UTC 时间格式，但是数据库的存储时间可能与本地时间存在时差问题，导致数据查询结果不一致。

例如，你的本地时间是 UTC+8 时区，然而你的数据存储在海外的 MongoDB 服务器上，其 UTC 时间比你的本地时间早 8 小时。此时，你查询数据的本地时间和 Mongo 数据库存储的时间的 UTC 时间不一致，就会导致时间戳查询失败。

为了避免这种问题，我们需要将 MongoDB 默认时区设置为 UTC 时间。在实际开发中，可以采用如下方式进行设置：

// 启动应用时，在 Mongoose 中设置 UTC 时区
mongoose.connect(mongoURI, { useNewUrlParser: true, useUnifiedTopology: true }).then(() => {
  mongoose.connection.db.command({ setParameter: 1, time zone: "+00:00" });
  console.log(`mongodb connected on ${envConfig.databaseUri}`);
}).catch((err) => {
  console.log(err);
});

在上述代码中，我们在使用 Mongoose 连接 MongoDB 数据库时，增加了一行代码：

mongoose.connection.db.command({ setParameter: 1, time zone: "+00:00" });

这行代码的作用是，在连接 MongoDB 数据库后，将其时区设置为 UTC+0。这样，即使你的本地时间与 MongoDB 存储的时间存在时差，也能够正确查询到数据的时间戳。

总结

本文详细介绍了 Mongoose 中时间戳的使用方法，同时分析了该功能在一些特殊场景下可能会出现的错误情况，并提供了相应的处理方式。可见，时间戳虽然是非常实用的功能，但在细节方面还是需要格外注意，只有掌握正确的使用方法，并针对常见的错误场景进行妥善处理，才能够更好地运用该功能，提升应用程序的可靠性和稳定性。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/652e0f4b7d4982a6ebf21b8d