MongoDB UTC与本地时间校准问题及时差修正逻辑排查

核心错误点 #

1. 时区偏移量（offset）取值完全颠倒 #

KST（韩国标准时间）比UTC快9小时，对应**+540分钟**，但代码中错误使用了-540。这会导致将当前UTC时间向后回拨9小时，而非转换为正确的KST时间，直接导致后续日期计算完全偏离目标时区。

2. 日期范围的转换逻辑错误 #

代码试图将转换后的KST日期直接映射为UTC的00:00:00到23:59:59，但实际上KST的完整一天对应的UTC区间是前一天的15:00:00到当天的15:00:00（因为KST=UTC+9）。

当KST处于午夜0点到9点时，对应的UTC时间是前一天的15点到当天的0点，而代码生成的查询范围是UTC当天的0点到23:59:59，完全覆盖不到KST当天0-9点的数据（这些数据的UTC时间属于前一天），因此查询结果异常。

修正后的代码逻辑 #

// KST比UTC快9小时，offset应为+540分钟
const offset = 540;
// 获取当前KST时间的moment实例
const kstNow = moment.utc().add(offset, 'm');
// 获取KST当天的起始和结束时刻（moment对象）
const kstBegin = kstNow.startOf('day');
const kstEnd = kstNow.endOf('day');

// 转换为UTC时间的Date对象，用于MongoDB查询
const beginDate = kstBegin.toDate();
const endDate = kstEnd.toDate();

// 正确的查询逻辑
const user = await userSchema.aggregate([
  { $unwind: 'lists' },
  {
    $match: {
      'lists.createdAt': {
        $gte: beginDate,
        $lte: endDate
      }
    }
  },
  ...
]);

额外优化建议 #

• 直接使用moment的startOf('day')和endOf('day')方法，避免手动拼接日期时间，减少出错概率。
• 确保MongoDB中存储的createdAt是标准UTC时间（Mongoose的Date.now默认存储UTC时间，这部分是正确的）。

内容的提问来源于stack exchange，提问作者Minwoo Kim