Spring Boot集成MongoDB时import_created_at过滤失效问题排查

1. 数据类型不匹配（最常见） #

• 检查MongoDB items集合中lastUpdate字段的实际类型：
  • 若MongoDB存储的是Date类型（ISODate格式），但代码传入的是Long型时间戳，直接用eq匹配会失败——MongoDB不会自动跨类型匹配。
  • 反之，若实体类lastUpdate定义为Date，但查询时传入Long且未做类型转换，同样会匹配失败。
• 错误示例（类型不匹配）：

  // MongoDB存Date，实体类用Long
  private Long lastUpdate;
  // 或MongoDB存Long，实体类用Date
  private Date lastUpdate;
  

2. 时间精度不一致 #

• 确认MongoDB中存储的lastUpdate毫秒数与传入的1661784425743完全一致：
  • 序列化/反序列化过程中可能丢失毫秒精度，或传入值与实际存储值存在细微差异（如差1毫秒），导致eq匹配失效。

3. 查询条件构建错误 #

• 检查findAllByFilters方法中lastUpdate的查询逻辑：
  • 是否误将$eq写成$gt/$lt等范围操作符？
  • 是否拼接条件时遗漏或覆盖了lastUpdate的过滤规则？
• 错误示例（操作符误用）：

  // 错误：使用大于操作符而非等于
  query.addCriteria(Criteria.where("lastUpdate").gt(lastUpdateValue));
  

4. 字段映射不匹配 #

• 核对实体类lastUpdate字段的@Field注解：
  • 若MongoDB集合中字段为下划线命名（如last_update），但实体类映射为驼峰（lastUpdate），会导致查询时无法定位字段，返回空结果。
• 错误示例（映射错误）：

  // MongoDB字段是last_update，实体类映射为lastUpdate
  @Field("lastUpdate")
  private Long lastUpdate;
  

5. 时区差异问题 #

• 若MongoDB存储的Date为UTC时间，而传入的时间戳对应本地时区，转换后会出现时间差：
  • 比如本地时区为东8区，传入的时间戳对应本地时间，但MongoDB存的是UTC时间，两者相差8小时，导致匹配失败。

6. 文档实际值不符 #

• 直接在MongoDB客户端执行验证查询：

  db.items.find({contractId: 1, lastUpdate: 1661784425743})
  

  • 若客户端查询也无结果，说明传入的lastUpdate值与文档实际值不一致，需核对数据。

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