第63章 错误处理

题目:订单金额校验——try-catch捕获业务异常并提示

某电商系统在创建订单时,需要对用户输入的金额进行严格校验:金额必须为正数且不超过每日限额 5000 元。若校验失败,需要捕获异常并给出清晰的中文提示,避免用户看到晦涩的英文错误。

设计思路

定义业务异常类 OrderError,继承内置 Error。主函数 placeOrder 中用 try-catch 捕获校验阶段的异常,并分类输出提示:非法金额与超限金额分别处理,最后用 finally 记录日志,确保资源清理或审计操作总能执行。

核心代码

class OrderError extends Error {
  constructor(message: string) {
    super(message);
    this.name = 'OrderError';
  }
}

function validateAmount(amount: number): void {
  if (!Number.isFinite(amount) || amount <= 0) {
    throw new OrderError('金额必须为正数');
  }
  if (amount > 5000) {
    throw new OrderError('单笔金额不能超过 5000 元');
  }
}

function placeOrder(amount: number): string {
  try {
    validateAmount(amount);
    return `订单创建成功,金额 ${amount} 元`;
  } catch (error) {
    if (error instanceof OrderError) {
      return `业务校验失败:${error.message}`;
    }
    return '系统异常,请稍后重试';
  } finally {
    console.log('[审计] 完成一次订单金额校验');
  }
}

console.log(placeOrder(100));   // 成功
console.log(placeOrder(-5));    // 非法金额
console.log(placeOrder(6000));  // 超限额

运行结果

[审计] 完成一次订单金额校验(三次执行)
依次输出:订单创建成功,金额 100 元、业务校验失败:金额必须为正数、业务校验失败:单笔金额不能超过 5000 元

注意事项

使用 instanceof 判断异常类型时,需确保子类与父类在同一个原型链上。若用 Object.create 方式构造异常,可能导致判断失效,建议始终用 class ... extends Error 定义业务异常。

成功要点

通过自定义错误类型区分业务异常与系统异常,try-catch 后对错误类型分流处理,而非一刀切地返回“系统错误”。这样能显著提升接口的可用性和可维护性。

测试建议

分别传入 100、-5、6000、NaN 四种值,观察输出是否符合预期,其中 NaN 应被 Number.isFinite 拦截。