$densify报错“field must be numeric or date”是因为字段路径下存在非数值/非日期值（如null、空字符串、对象），MongoDB要求所有文档严格符合类型约束，不隐式过滤。
$densify 在 MongoDB 6.0 中能直接补全时间序列缺失值，但必须满足三个硬性条件：字段是日期或数值类型、range.step 明确指定、date 类型时 range.unit 不可省略。
为什么 $densify 一运行就报错 “field must be numeric or date”
这不是类型判断不准，而是字段值在集合中实际存在非日期/非数值内容（比如 null、空字符串 ""、嵌套对象），哪怕只有一条文档触发，整个聚合就会中断。MongoDB 不做隐式过滤，它要求 field 路径下所有值严格符合类型约束。
实操建议：
- 先用
db.collection.find({ "timestamp": { $type: "date" } }).count()确认字段真实类型覆盖率 - 对疑似脏数据做预清洗：
{$set: { timestamp: { $cond: [{ $eq: [{ $type: "$timestamp" }, "date"] }, "$timestamp", null] } }} - 如果字段在内嵌文档里（如
sensor.readingTime），field必须写成"sensor.readingTime"，不能漏掉点号 - 字段名以
$开头（如$ts）会直接报语法错误，必须先用$project重命名
range.bounds 设为 "partition" 和 [min, max] 的行为差异
两者补全逻辑完全不同：前者按 partitionByFields 分组后，在每组内部各自取最小/最大时间戳作为边界；后者则无视文档分布，强制从数组指定的绝对时间点开始填充，哪怕集合里根本没有接近该时间的原始数据。
常见误用场景：
- 想对每个设备单独补全 24 小时数据，却用了
bounds: ["2026-01-01", "2026-01-02"]→ 结果是所有设备都从同一起点补，不是各自起始时间 - 用了
partitionByFields: ["deviceId"]却设bounds: "full"→ MongoDB 会扫描全集合找全局最早/最晚时间，效率低且可能跨天不一致 -
bounds: "partition"时，若某设备只有一条记录，$densify仍会基于该单点生成一个“长度为 0”的区间，不产生新文档（step 再小也没用）
date 类型 densify 必须配 unit，且 step 必须为整数
这是 MongoDB 6.0 的强制校验逻辑。例如字段是 Date 类型，range: { step: 30, bounds: "partition" } 会直接失败，报错信息明确提示 “unit is required for date field”。即使你心里清楚是“30 分钟”，MongoDB 也不接受隐含推断。
正确写法示例：
db.weather.aggregate([
{
$densify: {
field: "recordedAt",
partitionByFields: ["location"],
range: {
step: 30,
unit: "minute",
bounds: "partition"
}
}
}
])
注意：
-
unit只能是文档列出的字符串之一："millisecond"、"second"、"minute"等，拼错或大小写不符都会报错 -
step: 1.5对 date 字段非法；但对数值字段（如秒级时间戳）合法 - 如果原始数据是毫秒时间戳（
NumberLong），unit不可设，否则报错；此时应改用step: 900000表示 15 分钟
补全后如何避免重复插入或覆盖原始数据
$densify 本身不修改原集合，只在管道中生成新文档。但如果你后续接了 $merge 或 $out，而没控制好匹配条件，极易把 densify 出来的“空值行”覆盖掉真实数据。
关键防范点：
- densify 后立即用
$addFields标记来源：{ isDensified: { $ne: ["$value", null] } }，再在$merge的on字段中排除这些行 - 不要依赖
$merge的默认whenMatched: "replace"，显式写成whenMatched: "keepExisting"更安全 - 如果目标集合已有数据，先确认 densify 输出的
recordedAt是否与现有文档主键冲突（如复合唯一索引包含时间字段）
真正容易被忽略的是：densify 生成的文档中，除 field 外其他字段默认为 null 或缺失，不会继承上一条原始文档的上下文字段（如 location、unit）。需要手动用 $fill 或 $last + $group 填充，否则补全出来的全是“空壳”。
