javascript_错误处理的最佳实践_技术教程

错误处理需结合语言特性与环境构建容错机制；2. 同步错误用try-catch捕获并抛出带上下文的自定义错误；3. 异步错误通过async/await+try-catch或.catch()处理；4. 全局监听unhandledrejection和onerror上报未捕获异常；5. 定义语义化错误类型并记录结构化日志以提升可维护性。

JavaScript 错误处理的关键在于提前预防、合理捕获和有效反馈。只依赖 try-catch 并不能解决所有问题，真正的最佳实践是结合语言特性与运行环境，构建稳健的容错机制。

使用 try-catch 捕获同步错误

对于可能抛出异常的同步代码，比如 JSON 解析、数据转换或调用外部库，应主动用 try-catch 包裹。

避免让解析失败导致整个程序中断，例如处理用户输入的 JSON 字符串时务必加 try-catch
捕获后应记录必要信息，而不是简单吞掉错误
在 catch 块中可抛出自定义错误，便于上层统一处理

示例：

try {
  const data = JSON.parse(jsonString);
  return data;
} catch (error) {
  throw new Error('Invalid JSON format');
}

监听异步错误：Promise 和 async/await

异步操作中的错误无法被常规 try-catch 捕获，必须通过 .catch() 或 await 结合 try-catch 处理。

使用 async 函数时，await 调用要放在 try-catch 中
链式 Promise 务必以 .catch() 结尾，防止未处理的 rejection

避免在 then 中返回新 Promise 却不处理其错误

推荐写法：

async function fetchData() {
  try {
    const res = await fetch('/api/data');
    const result = await res.json();
    return result;
  } catch (error) {
    console.error('Request failed:', error);
    throw error;
  }
}

全局错误监听作为兜底

即使做了局部处理，仍可能遗漏某些错误。通过全局事件监听收集未被捕获的异常，有助于定位问题。

监听 window.onerror 捕获同步脚本错误
使用 window.addEventListener('unhandledrejection') 处理未捕获的 Promise rejection
在 Node.js 中监听 process.on('uncaughtException') 和 process.on('unhandledRejection')
生产环境中将错误上报至监控系统，如 Sentry 或自建日志服务

示例：

window.addEventListener('unhandledrejection', event => {
  console.warn('Unhandled promise rejection:', event.reason);
  // 上报错误
});

自定义错误类型与结构化日志

使用语义化的错误类型能让排查更高效。通过继承 Error 构造自定义错误，并附带上下文信息。

为不同业务场景创建特定错误类，如 ValidationError、NetworkError
在错误对象中添加 code、url、timestamp 等字段，方便分类分析
记录日志时包含堆栈信息（stack）但注意不要暴露敏感数据

定义方式：

class ValidationError extends Error {
  constructor(message, field) {
    super(message);
    this.name = 'ValidationError';
    this.field = field;
    this.code = 'VALIDATION_ERROR';
  }
}

基本上就这些。关键不是写多少 try-catch，而是清楚哪些地方会出错，以及出错后系统是否能继续运行或优雅降级。错误处理的本质是提升用户体验和系统可靠性，不复杂但容易忽略。