Express body parser修改POST请求体中的日期字段问题排查求助

为什么日期被修改？ #

Express的JSON解析器（原body-parser模块）依赖原生JSON.parse()处理请求体，当遇到符合ISO 8601格式的日期字符串时，会自动将其转换为UTC时区的Date对象。你看到的“日期变化”其实是时区表示的差异：客户端发送的是带本地时区偏移的日期（比如2024-05-20T00:00:00+08:00），服务器解析后转成Date对象，默认用服务器本地时区显示，或者输出UTC格式的字符串，但本质上时间戳是完全一致的。

至于设置process.env.TZ无效，是因为这个环境变量只改变Node.js中Date对象显示时的本地时区，不会影响JSON解析阶段将日期字符串转为Date对象的逻辑，也不会修改Date对象存储的UTC时间戳。

怎么解决？ #

根据你的需求选择以下方案：

方案1：保留原始日期字符串，禁止自动解析

如果需要完整保留客户端发送的时区偏移信息，不让解析器自动转换为Date对象，可以配置express.json()的reviver函数，过滤日期字符串直接返回：

app.use(express.json({
  reviver: (key, value) => {
    // 匹配标准ISO日期格式（含时区偏移或UTC标识）
    const isoDatePattern = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:[+-]\d{2}:\d{2}|Z)$/;
    if (typeof value === 'string' && isoDatePattern.test(value)) {
      return value; // 保留原始字符串格式
    }
    return value;
  }
}));

之后你可以用date-fns-tz或moment-timezone这类库，手动解析字符串并处理时区信息。

方案2：统一时区，让显示与客户端一致

如果只是希望服务器端显示的时区和客户端匹配，需要在Node.js进程启动时就设置时区（必须早于任何Date对象的创建）：

# 启动应用时指定时区（以上海时区为例）
TZ='Asia/Shanghai' node app.js

或者在代码最顶部设置环境变量：

// 必须放在所有导入和代码执行之前
process.env.TZ = 'Asia/Shanghai';

const express = require('express');
const app = express();
// 后续业务代码...

这样Date对象的toString()等方法会以你设置的时区显示时间，但要注意：Date对象底层仍然存储UTC时间戳，只是显示格式发生了变化。

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