如何通过Mongo查询/投影返回格式化的促销码校验接口响应

• 投影规则误用：原查询的投影配置仅指定返回匹配的codes数组，未显式声明需要回传couponId、value字段。按照Mongo的投影逻辑，除了显式标记为返回的字段，其他字段都会被排除，自然拿不到对应优惠券的优惠信息
• 空结果逻辑缺失：原代码用find()方法做查询，无匹配结果时直接返回空数组，没有对空结果做错误判断，直接将空数组作为200成功响应返回，不符合错误场景的返回要求
• 结构组装缺失：查询拿到的匹配code是嵌套在codes数组中的值，没有手动拆解为前端需要的扁平结构，最终返回格式和预期偏差较大

1. 改造核心校验方法validatePromoCode #

针对上面的问题调整查询逻辑：

• 用findOne()替代find()：因为每个促销码全局唯一，不可能跨文档重复，单文档查询比返回数组的查询更适合当前场景
• 投影配置中明确声明需要返回couponId、value字段，再用$elemMatch过滤出codes数组中匹配当前输入的那一个值，避免返回数组内所有的促销码
• 增加空结果判断：没有匹配文档时主动抛出带明确提示的业务错误，供下游接口层捕获
• 手动组装为前端需要的扁平返回结构

改造后的方法代码：

const validatePromoCode = async (code) => {
  try {
    const matchedDoc = await PromoCodesModel.findOne(
      // 查询条件：命中codes数组中包含传入code的文档
      { "codes": code },
      // 投影配置：排除_id，保留需要的业务字段，过滤出匹配的单个code值
      {
        _id: 0,
        couponId: 1,
        value: 1,
        codes: { $elemMatch: { $eq: code } }
      }
    )

    // 无匹配结果时抛出明确的业务错误
    if (!matchedDoc) {
      throw new Error("this is not valid code")
    }

    // 拆解数组中的匹配值，组装为要求的扁平返回结构
    return {
      value: matchedDoc.value,
      couponId: matchedDoc.couponId,
      code: matchedDoc.codes[0]
    }
  } catch (err) {
    // 向上抛出错误信息，供接口层统一处理
    throw new Error(err.message)
  }
}

2. 改造路由层响应逻辑 #

原来的路由中未对同步抛出的参数缺失错误做响应处理，且错误返回的结构不符合预期，需要调整为统一的成功/错误返回格式：

router.post('/promoCode', (req, res, next) => {
  const { promoCode } = req.body;
  console.log('this is the req.body.promoCode on /promoCode', promoCode)

  // 参数缺失时直接返回对应错误结构，避免抛出未捕获的同步异常
  if (!promoCode) {
    return res.status(400).json({ error: "A promoCode needs to be passed" })
  }

  promoCodesModel
    .validatePromoCode(promoCode)
    .then((response) => {
      console.log('response inside /promoCode', response)
      // 促销码校验通过，返回要求的成功结构
      res.status(200).json({ data: response })
    })
    .catch((error) => {
      // 校验失败，返回统一的错误结构
      res.status(400).json({ error: error.message })
    })
})

• 性能优化：因为要频繁在codes数组字段做匹配查询，记得给codes字段建普通索引，避免数据量上升后出现查询慢的问题：PromoCodesModel.createIndexes({ codes: 1 })
• 后期扩展提示：当前将多个促销码存在单文档内的结构适合小规模使用场景，如果后续促销码量级达到万级以上，单文档体积会过大，可考虑将每个促销码拆为独立文档，结构调整为{code, couponId, value}，查询效率会更高
• 规则校验：可以给codes数组里的字符串值配置大小写一致性，避免同一促销码因为大小写输入差异出现校验不通过的问题

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