如何在HTTPS云函数的Firestore事务中避免自定义错误被catch拦截

你当前的问题根源是外层通用捕获逻辑无差别拦截了所有抛出的错误，没有对“业务主动抛出的合法HTTPS错误”和“非预期系统异常”做区分，导致自定义的failed-precondition错误被强制改写为unavailable类型。
你只需要在catch块内新增错误类型判断规则，就能实现精准分流：

• 当捕获到的错误已经是functions.https.HttpsError的实例时，说明这是业务逻辑主动抛出的自定义错误，直接重新抛出原错误即可，不做任何改写。
• 当捕获的错误不属于上述自定义HTTPS错误类型时，才执行原有逻辑，将非预期异常统一转换为unavailable类型错误返回。

await firestore
  .runTransaction(async (transaction) =>
    transaction.get(userRef).then((doc) => {
      const { totalPoints } = doc.data();

      if (totalPoints > 1000) {
        // 正常事务执行逻辑
      } else {
        throw new functions.https.HttpsError(
          "failed-precondition",
          "You have less than 1000 points."
        );
      }
    })
  )
  .catch((err) => {
    // 优先放行所有业务侧主动抛出的合法HTTPS错误
    if (err instanceof functions.https.HttpsError) {
      throw err;
    }
    // 仅对非预期的系统异常做统一转换
    throw new functions.https.HttpsError(
      "unavailable",
      "Please, try again later."
    );
  });

• 不要依赖错误信息字符串做匹配判断，优先使用云函数SDK提供的HttpsError类做实例校验，避免出现误判。
• 这套判断规则可自动兼容后续业务新增的其他合法HTTPS错误类型（比如permission-denied、invalid-argument），不需要额外修改捕获逻辑。

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