MongoDB runCommand中日期存储为null问题求助：如何正确设置日期参数？

我之前在从Java调用MongoDB的runCommand处理日期时，也碰到过一模一样的坑——要么用ISODate()报错，要么用$date存成null，折腾了好一阵子才搞定，给你几个实用的解决方案：

1. 正确使用MongoDB扩展JSON的$date格式 #

你之前用$date存null的核心问题是日期格式不匹配：MongoDB的扩展JSON要求$date对应的字符串必须是ISO 8601标准格式（比如2018-02-09T00:00:00.000Z），而你传的2018-02-09 00:00:00.0带空格，MongoDB无法解析，所以存成了null。

正确的runCommand写法应该是这样的：

db.runCommand({
  insert: "your_collection_name",
  documents: [
    {
      start_date: { "$date": "2018-02-09T00:00:00.000Z" }
    }
  ]
})

从Java端处理时，需要把你的原始日期字符串转换成ISO格式：把空格替换成T，再加上时区标识Z（表示UTC时区，也可以指定其他时区比如+08:00）。

2. 优先用Java驱动构造日期对象（最可靠） #

直接拼字符串查询很容易踩格式坑，更稳妥的方式是用MongoDB Java驱动提供的日期类型来构造数据，驱动会自动帮你完成序列化，不用手动处理格式：

import org.bson.types.BsonDateTime;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.ZoneOffset;

// 解析你的原始日期字符串
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.S");
LocalDateTime dateTime = LocalDateTime.parse("2018-02-09 00:00:00.0", formatter);

// 转成UTC时间戳，构造BsonDateTime
long timestamp = dateTime.toInstant(ZoneOffset.UTC).toEpochMilli();
BsonDateTime mongoDate = new BsonDateTime(timestamp);

// 构造文档并插入（或用于runCommand）
Document doc = new Document("start_date", mongoDate);
yourCollection.insertOne(doc);

这种方式完全避开了字符串解析的问题，是生产环境中最推荐的做法。

3. 为什么ISODate()会报错？ #

在Mongo Shell里直接用ISODate("2018-02-09")是没问题的，但从Java传字符串形式的runCommand时，MongoDB是解析JSON格式，而不是执行JavaScript代码，所以ISODate()会被当成未定义的函数，自然报错。只有在执行JS脚本时，ISODate()才会生效。

总结 #

• 如果必须用字符串形式的runCommand：把日期转换成ISO 8601格式，配合$date使用；
• 优先选择Java驱动的日期对象构造数据，避免格式错误；
• 永远不要在JSON格式的runCommand里用ISODate()，改用扩展JSON的$date语法。

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