React传日期到NodeJS做日期范围搜索时日期多一天问题

这类日期传输后偏移的问题，核心诱因只有两类：时区处理逻辑不一致、参数序列化/反序列化时格式解析错误，按以下步骤排查即可定位解决： #

优先排查格式解析错误 #

你给出的日志里，前端发送的日期时分秒是00:00:33，服务端收到的变成00:13:58，偏移量不是整小时数，首先可以排除纯时区问题，优先检查参数传递链路：

• 前端发送环节检查：
  • 不要直接把Date对象作为参数传给请求方法，GET请求拼接query、POST请求序列化JSON时，默认的Date.toString()会输出本地时区格式的字符串，很容易被服务端解析错。
  • 检查项目里的请求拦截器、日期工具方法，有没有对日期参数做自动格式化，比如调用toLocaleString()、自定义日期拼接方法时写错了时分秒偏移。
  • 排查你用的日期选择器组件，部分组件的onChange返回值是本地时区的日期对象，如果你手动调用setHours(0,0,0,0)设置当日0点，实际设置的是本地时区0点，转成UTC时间后会偏移8小时（东八区场景），如果临界日期就会跳1天。
• 服务端接收环节检查：
  • 在请求最入口（所有参数解析中间件之前）打印原始请求的query/body值，看原始传过来的日期字符串和前端控制台打印的是否一致：如果原始值就不对，问题在前端发送链路；如果原始值正确，经过中间件处理后出错，检查qs、body-parser的配置，有没有开启自动日期转换，或者自定义参数转换逻辑写错了解析规则。

再排查时区不一致问题 #

如果原始参数值一致，转成Date对象后出现偏移，就是时区配置不统一导致：

• 分别在前端浏览器控制台、NodeJS服务端执行console.log(new Date().getTimezoneOffset())，该方法返回当前环境与UTC时区的分钟差：东八区（国内）返回-480，UTC时区返回0，如果两端返回值不同，就说明时区配置不一致。
• 检查Mongoose读写逻辑：MongoDB默认以UTC格式存储时间，如果你写入数据时用了本地时间计算，查询时用UTC时间匹配，就会出现固定时差。

零偏移的落地方案 #

跨端传递日期不要用字符串格式，统一传递13位毫秒时间戳，可以100%避免时区、格式解析导致的偏移：

1. 前端发送前把日期转成时间戳：

const searchParams = {
  // 不要直接传Date对象，转成绝对时间戳
  startDate: startDate.getTime(),
  endDate: endDate.getTime()
}

2. 服务端接收后直接转成Date对象用于查询：

// 转成数字后实例化Date，不会有任何偏移
const queryStart = new Date(Number(req.query.startDate))
const queryEnd = new Date(Number(req.query.endDate))
const search = { $or: [{createdAt:{$gte: queryStart, $lt: queryEnd }}]};

如果必须传递日期字符串，两端统一约定用UTC标准处理：生成日期范围时用Date.UTC()方法指定UTC时区的年月日时分秒，全程不要混用getHours()、toLocaleDateString()这类本地时区方法，转成带Z后缀的ISO字符串传输，服务端直接实例化不要做额外时区转换。 #

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