Node.js应用迁移至Azure Cosmos API后使用MongoDB $expr按年份查询报错

• 直接触发unknown operator: $expr的根本原因：Azure Cosmos DB 用于MongoDB的API存在版本兼容边界，$expr操作符仅在Cosmos DB MongoDB API兼容版本≥3.6的实例上才被支持，若当前实例的兼容版本配置低于3.6，会直接抛出不识别该操作符的异常。
• 原查询代码本身存在两处语法/逻辑错误，就算匹配到Cosmos DB的兼容版本也无法正常返回结果：
  • 日期匹配的类型不匹配：$year聚合计算返回的是数字类型，原代码里传入对比的是字符串'2018'，类型不一致会导致查询结果为空
  • $in语法使用错误：$in操作符要求传入数组类型的匹配值，原代码直接把字符串'Completed'作为$in的参数，原生MongoDB环境下也会抛出参数格式错误。

要实现“筛选2018年创建的项目记录”的需求，不需要依赖$expr聚合操作符，采用时间区间匹配的写法，能最大化Cosmos DB兼容度，同时还能命中字段索引提升查询效率：

// 预先计算目标年份的时间边界
const year2018Start = new Date('2018-01-01T00:00:00.000Z');
const year2019Start = new Date('2019-01-01T00:00:00.000Z');

const queryObj = {
  $and: [
    { devType: 'Web Development' },
    { category: 'Project' },
    { assignedDev: '5ad676ca8341f186e8ad7764' },
    // 用区间匹配替代原$expr的年份提取逻辑
    { createdOn: { $gte: year2018Start, $lt: year2019Start } },
    // 修正$in的数组参数格式
    { status: { $in: ['Completed'] } }
  ]
};

Project.find(
  queryObj,
  {id:1, submitterID:1, submitterFullName:1, title:1, devType:1, desiredDate:1, priority:1, category:1, createdOn:1, status:1}
)
.populate({
  path: 'assignedDev',
  select: {fName:1, lName:1},
  options: { lean: true}
})
.lean()
.limit(500)
.then(project => {
  console.log(project);
});

• 上述区间匹配写法不需要任何聚合操作符，在所有版本的Cosmos DB MongoDB API上都可正常运行，查询性能远高于聚合表达式查询
• 如果业务场景必须使用$year类日期函数做筛选，可先将Cosmos DB实例的MongoDB API兼容版本升级到3.6及以上，同时将原$expr中的对比值从字符串'2018'改为数字类型2018，消除类型不匹配问题。

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