JavaScript错误处理实例：try-catch捕获异常与自定义Error对象

在 JavaScript 开发过程中，未捕获的运行时异常往往会导致脚本执行中断、用户界面卡死或状态不一致。构建高可用前端应用或 Node.js 服务端，核心在于建立可预测的错误防御机制：通过 try-catch-finally 精确控制异常流，以及利用面向对象特性扩展标准 Error 类构造业务领域专用的异常对象。本文将结合执行机制与完整代码实例，详解异常捕获流程、原型结构、异步边界与多层级错误治理方案。

一、try-catch-finally 基础语法与执行逻辑

try-catch 语句提供了一种捕获代码块运行时错误的结构。其执行顺序遵循确定性的控制流转向：一旦 try 块内部发生异常，引擎会立刻停止 try 块中后续代码的执行，并将控制权连同抛出的错误对象移交给 catch 块。无论是否发生异常，可选的 finally 块最终都会无条件执行。

function parseUserData(jsonString) {
  try {
    const data = JSON.parse(jsonString);
    console.log("解析成功:", data.username);
    return data;
  } catch (error) {
    console.error("解析失败:", error.message);
    return null;
  } finally {
    console.log("parseUserData 执行完毕，完成清理工作。");
  }
}

// 正常测试调用
parseUserData('{"username": "Alice"}');

// 异常测试调用（传入非法 JSON）
parseUserData('{ invalid_json }');

执行流程的关键细节在于 finally 块的执行优先级：即使 try 或 catch 块中包含 return、break 或 continue 语句，finally 块中的代码也必定会先于当前函数实际返回之前执行。如果 finally 块中显式使用了 return，则会覆盖前面所有代码块的返回值。

二、内置 Error 对象的结构与类型判定

JavaScript 提供了内建的 Error 构造函数。当运行时产生错误或显式 throw new Error("信息") 时，生成的实例包含三个核心属性：

• name：错误的名称标识，在基础 Error 中默认为 "Error"。
• message：可读的错误描述文本。
• stack：执行上下文的调用栈跟踪信息（非标准但主流引擎通用支持），用于排查故障源头行号及链路。

ECMAScript 规范在基类 Error 之上派生了多种内置错误类型，用于指示特定场景的违规操作：

• TypeError：变量类型不匹配或调用非函数对象时触发（例如 null.f()）。
• ReferenceError：引用未声明的变量时触发。
• RangeError：数值超出合法边界（例如数组长度为负数或递归深度溢出）。
• SyntaxError：解析不符合 JavaScript 语法的代码（例如 eval 或 JSON.parse 解析错误数据）。

在捕获异常时，推荐使用 instanceof 操作符进行分流处理，而不是通过字符串模糊匹配 message：

function handleSpecificError(action) {
  try {
    action();
  } catch (err) {
    if (err instanceof TypeError) {
      console.warn("[类型错误] 参数或方法调用不合法:", err.message);
    } else if (err instanceof ReferenceError) {
      console.error("[引用错误] 访问了不存在的变量:", err.message);
    } else {
      console.error("[未知错误]:", err);
      throw err; // 不可处理的错误重新向外抛出
    }
  }
}

三、同步与异步调用栈中的异常捕获边界

很多开发者在刚接触 JavaScript 异步编程时容易陷入误区：试图使用同步的 try-catch 块直接包裹 setTimeout 或原生回调。这是行不通的。

// 错误示例：无法捕获异步回调内的异常！
try {
  setTimeout(() => {
    throw new Error("异步定时器异常"); // 导致全局未捕获异常，进程崩溃或报错
  }, 100);
} catch (e) {
  console.log("此处永远不会被执行！");
}

// 正确示例：在异步回调内部构建独立的捕获逻辑
setTimeout(() => {
  try {
    throw new Error("内部正常捕获的异步异常");
  } catch (e) {
    console.log("成功捕获:", e.message);
  }
}, 100);

// 现代方案：使用 async/await 将异步操作拉平，利用标准 try-catch
async function executeTask() {
  try {
    const res = await fetch("/api/data");
    const json = await res.json();
    return json;
  } catch (err) {
    console.error("异步网络或解析失败:", err.message);
  }
}

四、继承 Error 构建自定义异常对象

内置的 Error 类只能携带单纯的字符串描述信息，无法很好地表达业务逻辑中的错误状态（例如 HTTP 状态码、表单未通过的具体字段、业务错误编码等）。利用 ES6 类继承语法，可以方便地扩展领域自定义异常体系。

编写高质量自定义 Error 对象时，有三个关键准则：

1. 必须调用 super(message)：确保父类 Error 完成标准属性初始化。
2. 覆盖 this.name：将其显式设置为子类类名，便于日志追踪和输出区分。
3. 使用 Error.captureStackTrace（V8/Node.js/现代浏览器）：裁剪自定义构造函数自身的帧，让调用栈直接指向外部调用点。

// 基础业务应用错误类
class AppError extends Error {
  constructor(message, statusCode = 500, errorCode = "INTERNAL_SERVER_ERROR") {
    super(message);
    this.name = this.constructor.name;
    this.statusCode = statusCode;
    this.errorCode = errorCode;

    // 优化调用栈显示，消除构造函数内部调用帧
    if (Error.captureStackTrace) {
      Error.captureStackTrace(this, this.constructor);
    }
  }
}

// 客户端输入数据校验异常
class ValidationError extends AppError {
  constructor(message, validationDetails = []) {
    super(message, 400, "VALIDATION_FAILED");
    this.details = validationDetails; // 存储字段级别的错误描述列表
  }
}

// 资源不存在异常
class NotFoundError extends AppError {
  constructor(resourceName, identifier) {
    super(`资源 [${resourceName}] 标识为 '${identifier}' 未找到`, 404, "RESOURCE_NOT_FOUND");
    this.resourceName = resourceName;
    this.identifier = identifier;
  }
}

五、综合实战实例：用户注册校验与异常分层处理

下面通过一个完整的模拟用户注册函数，演示如何结合 try-catch、instanceof 以及自定义 ValidationError、AppError，实现干净的错误分流控制。

// 模拟用户注册服务
function registerUser(payload) {
  // 1. 模拟基础参数类型校验
  if (typeof payload !== "object" || payload === null) {
    throw new TypeError("注册载荷必须为有效对象");
  }

  const errors = [];

  // 2. 字段业务规则校验
  if (!payload.username || payload.username.length < 3) {
    errors.push({ field: "username", reason: "用户名长度至少需要 3 个字符" });
  }

  if (!payload.email || !payload.email.includes("@")) {
    errors.push({ field: "email", reason: "电子邮箱格式不正确" });
  }

  if (errors.length > 0) {
    // 抛出带有详细错误信息的自定义校验异常
    throw new ValidationError("用户提交表单校验未通过", errors);
  }

  // 3. 模拟业务冲突判断
  if (payload.username === "admin") {
    throw new AppError("禁止注册保留系统账号", 409, "USER_ALREADY_EXISTS");
  }

  return { id: 1001, username: payload.username, email: payload.email, status: "active" };
}

// 客户端调用层：统一异常分流处理
function handleRegisterRequest(userInput) {
  console.log("\n---------------- 开始处理注册请求 ----------------");
  try {
    const result = registerUser(userInput);
    console.log("【处理成功】用户注册完成:", result);
    return { success: true, data: result };
  } catch (err) {
    if (err instanceof ValidationError) {
      // 客户端校验错误，展示具体字段指引
      console.warn(`【校验失败 - ${err.statusCode}】${err.message}`);
      console.table(err.details);
      return { success: false, code: err.errorCode, errors: err.details };
    } else if (err instanceof AppError) {
      // 业务冲突或受控业务错误
      console.warn(`【业务受限 - ${err.statusCode}】${err.message} (${err.errorCode})`);
      return { success: false, code: err.errorCode, message: err.message };
    } else if (err instanceof TypeError) {
      // 代码调用方式错误
      console.error("【系统接口调用异常】传入非法参数类型:", err.message);
      return { success: false, code: "BAD_PARAM_TYPE", message: "参数结构无效" };
    } else {
      // 未知未知异常，打印原始堆栈，记录报警日志
      console.error("【未知致命故障】需要告警关注:", err);
      return { success: false, code: "UNKNOWN_ERROR", message: "系统繁忙，请稍后重试" };
    }
  } finally {
    console.log("---------------- 请求处理流程结束 ----------------");
  }
}

// 测试用例 1：传入非法表单数据
handleRegisterRequest({ username: "a", email: "invalid-email" });

// 测试用例 2：传入系统保留冲突账号
handleRegisterRequest({ username: "admin", email: "admin@example.com" });

// 测试用例 3：正常合法数据
handleRegisterRequest({ username: "charlie", email: "charlie@example.com" });

运行结果中，不同异常类型各司其职：输入错误返回详细的 details 数组以便前端高亮红框，业务冲突返回对应状态码与消息，底层未知异常则对用户屏蔽细节并保留日志，保障系统健壮性。

六、现代全链路异常防御策略总结

在实际生产架构中，单点 try-catch 无法包揽所有可能发生的异常。成熟的项目应当遵循“分层截获、全局兜底”的原则进行全生命周期的异常防御：

• 数据与底层 I/O 层：使用局部 try-catch 将底层异常（如网络超时、JSON 格式解析失败、数据库连接重置）包装为结构统一的业务 AppError 向上传播。
• 业务控制器/路由层：通过框架中间件（如 Express/Koa 错误中间件，或 React Error Boundary）拦截已知异常，映射为标准 HTTP 状态码及 JSON 响应。
• 全局宿主兜底层：监听全局事件（浏览器的 window.addEventListener('unhandledrejection')、window.onerror，或 Node.js 的 process.on('uncaughtException')），捕获逃逸的未知异常并上报监控日志系统，防止主进程静默崩溃。