必须始终用 isodate 存储 utc 时间，禁用字符串或本地时间戳；显式存 timezone_offset_minutes 字段记录用户时区偏移，查询时先换算为 utc 范围再过滤，展示层才做本地化。
存时间必须用 ISODate，别用字符串或本地时间戳
MongoDB 本身不存储时区信息，ISODate 在底层是 UTC 时间戳（毫秒数），但 shell 或驱动显示时会按本地时区格式化——这容易让人误以为它“记了时区”。一旦你用 new Date('2024-05-01T12:00:00+0800') 或字符串插入，MongoDB 会尝试解析并转成 UTC 存储，但行为不稳定：Node.js 驱动可能按系统时区解释字符串，Python 的 pymongo 对含偏移的字符串处理也不一致。
- 永远用
new Date(Date.UTC(2024, 4, 1, 4, 0, 0))或等价的 UTC 构造方式生成时间值 - Node.js 中推荐用
new Date().toISOString()（它强制输出 UTC 字符串），再由驱动自动转为ISODate - 禁止存类似
"2024-05-01T12:00:00+0800"这种带本地偏移的字符串字段——它查起来没法直接比较、排序、聚合 - 如果已有字符串时间字段，别试图用
$dateFromString加timezone参数“修正”，因为源字符串时区语义模糊，结果不可靠
显式存 timezone_offset_minutes 字段，而不是推导
用户提交的时间总带上下文（比如“东京时间下午3点”），光靠 UTC 时间无法还原原始感知时间。这时候不能依赖客户端传来的 Intl.DateTimeFormat().resolvedOptions().timeZone，因为浏览器/设备时区可能被手动改过，或用户在跨时区旅行中没切系统设置。
- 前端应主动采集并上传偏移量：用
new Date().getTimezoneOffset()（注意它是分钟数，且西为正，东为负，比如东八区返回-480） - 后端存为独立字段，例如
timezone_offset_minutes: -480，类型固定为整数，不要存 IANA 时区名（如"Asia/Shanghai"），后者有夏令时歧义且查询慢 - 这个字段和
created_at（UTC）必须一起写入，原子操作；不能靠应用层“事后补全”，否则并发写入或重试会导致不一致 - 聚合查询时，可用
{$add: ["$created_at", {"$multiply": ["$timezone_offset_minutes", 60000]}]}算出本地毫秒时间用于展示，但仅限展示，别用于条件过滤
查询时别用 $hour/$minute 直接匹配本地时间
MongoDB 的日期聚合操作符（如 $hour、$dateToString）默认按 UTC 解析，若强行指定 timezone 参数，会触发服务器端时区转换——但 MongoDB 4.0+ 的 timezone 只支持 IANA 名（如 "Asia/Tokyo"），不支持动态偏移量字段，也无法引用文档内的 timezone_offset_minutes 值。
- 想查“用户本地时间上午9点创建的记录”？别在 query 层做转换，先算好对应 UTC 时间范围：比如用户偏移
-480分钟，则本地 9:00 → UTC 1:00，查{created_at: {$gte: utcStart, $lt: utcEnd}} - 避免在
$dateToString中硬编码timezone: "Asia/Shanghai"，生产环境服务器可能没装 tzdata，或版本不一致导致解析失败 - 如果必须返回本地格式字符串，让应用层做（用
toLocaleString或dayjs.utc().tz()），MongoDB 只管存和查 UTC
Driver 和 shell 显示差异会让调试变迷糊
mongo shell 默认用本地时区显示 ISODate，而 Node.js 的 console.log(doc) 也走 JS runtime 本地规则，但实际存的仍是 UTC。这种“看起来对、其实错”的错觉，是跨国项目里最常踩的坑。
- 在 shell 里确认数据是否真为 UTC：用
ISODate().getUTCHours()手动验证，别只看ISODate("...")的打印结果 - Node.js 驱动开启
useUTC: true选项（默认已启用），确保Date实例从 BSON 解析时不被悄悄转成本地时间 - 用
mongosh时加--eval "db.runCommand({getCmdLineOpts: 1})"检查是否启用了utc时区配置（虽不影响存储，但影响 shell 输出） - 日志里打时间字段时，统一用
.toISOString()，别用.toString()—— 后者会暴露本地时区，干扰排查
