express 默认不会捕获路由处理器中抛出的异步错误（如 async 函数内的 throw），导致进程崩溃；需显式调用 next(err) 将错误传递给全局错误处理中间件。
express 默认不会捕获路由处理器中抛出的异步错误（如 async 函数内的 throw），导致进程崩溃；需显式调用 next(err) 将错误传递给全局错误处理中间件。
在 Express 应用中，全局错误处理中间件（四参数形式：(err, req, res, next)）仅对通过 next(err) 主动传递的错误生效，而不会自动捕获未被拦截的同步异常或异步拒绝（如 async 路由中直接 throw）。这就是为什么你在主 server.js 中 GET /update 抛出的错误能被正确捕获（Express 内部已封装为同步流程），但在 SubRouter.js 的 async 路由中 throw new Error("Testing") 却导致服务崩溃——因为该异常未被 try/catch 捕获，也未调用 next()，从而逃逸出 Express 错误处理链。
✅ 正确做法：确保所有错误都流向 next()
方案一：手动 try/catch + next(err)
// ./routes/SubRouter.js
import { Router } from "express";
const SubRouter = Router();
SubRouter.get("/update", async (req, res, next) => {
try {
// 模拟可能失败的异步操作
await Promise.reject(new Error("Database connection failed"));
} catch (err) {
return next(err); // ✅ 关键：将错误交由全局中间件处理
}
});
export default SubRouter;⚠️ 注意：async 函数中 throw 不会自动触发 next()，必须显式 catch 并 next(err)。
方案二：使用包装器函数（推荐，避免重复代码）
创建一个 asyncHandler 工具函数，自动代理 async 路由的错误：
// utils/asyncHandler.js export const asyncHandler = (fn) => (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);
然后在路由中直接使用：
// ./routes/SubRouter.js
import { Router } from "express";
import { asyncHandler } from "../utils/asyncHandler.js";
const SubRouter = Router();
SubRouter.get(
"/update",
asyncHandler(async (req, res) => {
throw new Error("Testing"); // ✅ 自动被捕获并传给 next()
})
);
export default SubRouter;方案三：自定义错误类 + 统一错误处理器（生产级实践）
为提升可维护性与语义化，建议结合自定义错误类与集中式错误处理：
// errors/HttpError.js
class HttpError extends Error {
constructor(message, statusCode = 500) {
super(message);
this.statusCode = statusCode;
this.status = `${statusCode}`.startsWith('4') ? 'fail' : 'error';
this.isOperational = true;
Error.captureStackTrace(this, HttpError);
}
}
export class BadRequestError extends HttpError {
constructor(message = 'Bad request') {
super(message, 400);
}
}
export class InternalServerError extends HttpError {
constructor(message = 'Internal server error') {
super(message, 500);
}
}在路由中使用：
import { BadRequestError, InternalServerError } from "../errors/HttpError.js";
SubRouter.get("/update", asyncHandler(async (req, res) => {
if (!req.query.id) throw new BadRequestError('ID is required');
const data = await fetchUserData(req.query.id);
if (!data) throw new InternalServerError('User not found');
res.json({ data });
}));并在主应用中注册全局错误中间件（务必放在所有路由之后）：
// server.js（末尾）
server.use((err, req, res, next) => {
console.error('❌ Unhandled error:', err);
// 仅对继承自 HttpError 的错误返回结构化响应
if (err.isOperational) {
return res.status(err.statusCode).json({
status: err.status,
message: err.message,
});
}
// 兜底：记录未知错误，返回通用提示
console.error('? Critical error:', err);
res.status(500).json({
status: 'error',
message: 'Something went wrong!',
});
});? 关键总结
- Express 不自动捕获 async 路由中的 throw，必须通过 try/catch + next(err) 或工具函数透传；
- 全局错误中间件 必须置于所有 app.use() 和路由挂载之后，否则无法生效；
- 使用 asyncHandler 包装器可显著减少样板代码，是现代 Express 项目的标准实践；
- 自定义错误类（如 BadRequestError）配合状态码，让错误处理更清晰、可测试、易国际化。
遵循以上模式，即可彻底避免“未捕获异常导致服务器崩溃”，构建健壮、可维护的 Express 错误处理体系。
