提交传感器数据至API时触发MongoServerError：'timestamp_property'需为有效BSON UTC日期时间值

看起来你遇到的问题是MongoDB时间序列集合对timestamp_property的类型要求格外严格——虽然你在测试代码里明确用了new Date()创建日期对象，但当通过supertest发送请求时，这个对象会被自动序列化为JSON字符串，而不是直接传递MongoDB期望的BSON日期类型，这大概率就是报错的根源。

我帮你梳理几个可能的原因和对应的解决办法：

1. JSON序列化导致Date对象变为字符串 #

当你调用supertest的.send()方法时，JavaScript的Date对象会被转成ISO 8601格式的字符串（比如"2024-05-20T12:34:56.789Z"）。虽然Mongoose通常能把这种字符串自动转换为Date类型，但MongoDB的时间序列集合是在数据库层面直接验证timeField的，可能在Mongoose完成类型转换之前就触发了错误。

解决办法：

• 要么在测试代码里手动把日期转成UTC格式的ISO字符串再发送：

  const sensorData = {
    name: "New Sensor",
    property_2: "Room B",
    timestamp_property: new Date().toISOString(), // 确保是UTC格式的字符串
    metadata_property: { location: "Lab 2", type: "Humidity" },
  };
  

• 要么在后端的POST接口里，主动把接收到的字符串转为Date对象：

  // 假设这是你的接口处理逻辑
  app.post('/api/sensors/:id/data', async (req, res) => {
    // 显式转换日期字段
    req.body.timestamp_property = new Date(req.body.timestamp_property);
    // 后续的Mongoose操作...
  });
  

2. 时区问题导致日期非UTC格式 #

虽然new Date()在JS内部存储的是UTC时间，但它的默认序列化结果可能带本地时区偏移（比如"2024-05-20T14:34:56+02:00"），这种格式MongoDB可能不认可为有效的UTC datetime。

解决办法：
用toISOString()方法生成标准UTC格式的日期字符串，它的结果总是以Z结尾（代表UTC时区），能确保MongoDB识别为有效日期。

3. 给Mongoose模型添加明确的日期验证 #

你可以给Schema里的timestamp_property字段加上自定义验证，确保传入的值是有效的Date类型，同时也能帮你排查数据是否符合要求：

const TaskSchema = new mongoose.Schema(
  {
    name: String,
    property_2: String,
    timestamp_property: {
      type: Date,
      required: true,
      validate: {
        validator: function(v) {
          return v instanceof Date && !isNaN(v);
        },
        message: props => `${props.value} 不是有效的日期值！`
      }
    },
    metadata_property: Object,
  },
  {
    timeseries: {
      timeField: "timestamp_property",
      metaField: "metadata_property",
      granularity: "hours",
    },
  }
);

另外还有个小建议：你可以在后端接口里打印一下接收到的timestamp_property的类型和具体值，比如：

console.log("接收到的日期：", typeof req.body.timestamp_property, req.body.timestamp_property);

这样能直接确认问题是出在测试代码的发送环节，还是后端的接收处理环节。

备注：内容来源于stack exchange，提问作者Bob