Mongoose按ObjectId查询返回空结果，MongoDB Compass却可查到的原因

• DOCUMENT_ID格式或类型无效
  如果DOCUMENT_ID不是24位的十六进制字符串（比如长度不对、包含非0-9/a-f/A-F的字符），new mongoose.Types.ObjectId(DOCUMENT_ID)会生成无效的ObjectId，导致查询无结果。而MongoDB Compass会自动尝试将字符串ID转换为合法的ObjectId，因此能正常匹配。需要检查DOCUMENT_ID的完整性和格式正确性。

• 模型中_id字段类型定义不匹配
  若CollectionModel里将_id手动定义为String类型（而非默认的mongoose.Schema.Types.ObjectId），用mongoose.Types.ObjectId()生成的ObjectId去匹配字符串类型的字段，会出现类型不匹配导致查询失败。此时需核对模型的_id字段定义是否与数据库存储类型一致。

• 集合名称不匹配
  Mongoose默认会将模型名转为小写复数形式作为集合名（例如CollectionModel对应collectionmodels），如果数据库中的实际集合名不同（比如collection），就会查询错误的集合返回空结果。而Compass是直接选择目标集合查询，所以能正常返回。可在定义模型时通过第三个参数指定集合名：mongoose.model('Collection', schema, 'your-target-collection')。

• ObjectId大小写匹配问题
  虽然MongoDB的ObjectId理论上大小写不敏感，但Mongoose的查询可能严格匹配大小写。如果DOCUMENT_ID中的字母大小写与数据库存储的不一致，会导致匹配失败，而Compass会自动处理大小写差异。可尝试将DOCUMENT_ID转为小写后再生成ObjectId重试。

• Mongoose类型转换配置异常
  若在数据库连接或模型配置中关闭了strictQuery或相关自动类型转换选项，可能导致字符串ID无法被正确转换为ObjectId进行匹配。可检查连接配置是否存在strictQuery: false等影响类型转换的设置，确认自动转换功能正常。

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