错误处理

这一课你将能做到

1. 区分四类错误的处理方式：同步异常、Promise 拒绝、回调错误、全局兜底
2. 定义业务错误类并携带状态码，把错误一路传到统一的出口
3. 配置 uncaughtException / unhandledRejection 兜底，并知道它们救不了什么

为什么要学

代码只写「正常路径」等于只盖了半栋楼。Node 的错误处理格外要命的一点是：一个没接住的异步错误，默认行为是整个进程崩掉——所有正在服务的请求全部陪葬。生产上「凌晨三点进程消失」的事故，多半就是某处异步错误没人接。

人话：错误处理就是把「失控的崩溃」变成「可控的失败」——该重试的重试、该返回 400 的返回 400、实在救不了的优雅退出并留下日志。这课是前面所有课程的地基加固：fs、http、Express、流，每一层的错误都各有脾气。

先建立图像

错误的四种来源与对应处理：

┌───────────────────┬────────────────────────────┐
│ 同步代码 throw     │ → try/catch               │
│ Promise reject     │ → .catch / await+try/catch │
│ 回调 error-first   │ → 判断第一个参数 err        │
│ EventEmitter error │ → 监听 'error' 事件        │
└───────────────────┴────────────────────────────┘
四层都失守 → uncaughtException / unhandledRejection → 进程兜底

错误的两大类型：
  运行期错误（Operational）：文件不存在、网络超时、参数非法
      → 预期内，捕获、重试或返回给调用方
  程序员错误（Programmer）：调错 API、null 解引用、逻辑漏洞
      → 预期外，修 bug；兜底日志 + 重启进程

先分清「哪类错误」，再决定「怎么处理」——很多新手把程序员错误也用重试硬扛，越扛越糊涂。

跟着做

步骤 1：同步异常与 try/catch

新建 node-errors 目录，npm init -y，新建 sync.js：

// sync.js
function parseConfig(raw) {
  const obj = JSON.parse(raw);        // 非法 JSON 会同步 throw
  if (!obj.port) {
    throw new RangeError('配置缺少 port 字段');   // 主动抛
  }
  return obj;
}

// 错误的 JSON：触发 JSON.parse 的 SyntaxError
try {
  parseConfig('{oops');
} catch (err) {
  console.log('捕获 1:', err.name, '-', err.message);
}

// 合法 JSON 但缺字段：触发自定义 RangeError
try {
  parseConfig('{"host":"localhost"}');
} catch (err) {
  console.log('捕获 2:', err.name, '-', err.message);
} finally {
  console.log('finally 无论成败都执行（适合清理）');
}

node sync.js
# 捕获 1: SyntaxError - Unexpected token 'o'...
# 捕获 2: RangeError - 配置缺少 port 字段
# finally 无论成败都执行（适合清理）

Error 三件套：message（人读的描述）、name（错误类型名）、stack（调用栈，排障金线索）。

步骤 2：Promise 与 async/await 的捕获

// async-errors.js
const fsp = require('node:fs/promises');

// 写法一：.then / .catch 链式
function byThen() {
  fsp.readFile('不存在的文件.txt', 'utf8')
    .then((data) => console.log(data))
    .catch((err) => console.log('then/catch 捕获:', err.code));  // ENOENT
}

// 写法二：await + try/catch（推荐）
async function byAwait() {
  try {
    const data = await fsp.readFile('不存在的文件.txt', 'utf8');
    console.log(data);
  } catch (err) {
    console.log('await 捕获:', err.code);                          // ENOENT
  }
}

async function main() {
  byThen();
  await byAwait();
}

main();
// then/catch 捕获: ENOENT
// await 捕获: ENOENT