讲师中心 微信公众号
AI工具推荐 视频效率加速

异常处理进阶:构建企业级健壮应用的错误监控与防御体系

梦辰酱_7924

梦辰酱_7924

发布时间:2026-02-14 13:45:11

|

739人浏览过

|

来源于php中文网

原创

uncaughtException仅捕获同步未捕获错误,unhandledRejection专捕未处理Promise拒绝;二者均非兜底方案,触发后应记录并exit(1),不可继续服务。

异常处理进阶:构建企业级健壮应用的错误监控与防御体系

Node.js 中 uncaughtException 和 unhandledRejection 的区别与误用

这两个钩子不是兜底方案,而是最后的“抢救窗口”——错过就进程退出。很多人把它们当 try/catch 的全局替代,结果日志写了、错误吞了,服务却悄悄卡死或内存泄漏。

  • uncaughtException 只捕获同步代码中未被 catch 的 Error,比如 JSON.parse('{') 或手动 throw new Error();它**不捕获 Promise 拒绝、异步回调里的错误、未监听的 EventEmitter 错误**
  • unhandledRejection 专治 Promise 链末端没写 .catch() 或 await 后没包 try 的情况,但**不会触发 if Promise 被正常 reject 后又被另一个 .catch() 捕获**
  • 两者都**不能安全地继续提供服务**:Node.js 官方明确说,uncaughtException 触发后堆栈已损坏,再发 HTTP 响应可能失败;强行 process.exit(0) 会跳过 graceful shutdown
  • 正确做法是记录错误 + 触发一次 process.exit(1),同时靠 PM2 / Kubernetes 等外部进程管理器拉起新实例

Express 中 next(err) 传错类型导致 500 静默丢失

Express 的错误中间件只认 Error 实例,传字符串、数字、对象进去,err.status 和 err.message 全失效,最终 fallback 到默认 500 页面,连日志都看不出错在哪。

  • 常见错误写法:next('User not found')、next({ code: 'NOT_FOUND' })、next(404)
  • 正确写法必须是 Error 子类:next(new Error('User not found')),或自定义类:class NotFoundError extends Error { constructor(msg) { super(msg); this.status = 404; } }
  • 如果用 TypeScript,next() 的类型提示会帮你拦住非 Error 类型,但 JS 项目得靠 ESLint 插件 eslint-plugin-express 的 express/no-missing-error-handler 规则
  • 别在路由里写 res.status(500).send() 代替 next():这样绕过了所有全局错误中间件,日志、告警、Sentry 上报全丢

Sentry 初始化时机不对,导致启动期错误不上报

Node.js 应用刚启动时发生的错误(比如配置文件读取失败、DB 连接超时、环境变量缺失)最容易漏监控——因为 Sentry SDK 还没 ready。

  • 典型错误顺序:先 require('./config') → 报错 → 再 require('@sentry/node') → Sentry.init()
  • 必须把 Sentry.init() 放在所有业务 require 之前,最好作为入口文件第一行(index.js 顶部),且加 try/catch 包裹自身初始化逻辑
  • 对 uncaughtException 和 unhandledRejection 的集成,要显式传 integrations: [new Sentry.Integrations.OnUncaughtException(), new Sentry.Integrations.OnUnhandledRejection()],否则默认不启用
  • 本地开发时设 enabled: process.env.NODE_ENV === 'production' 是好习惯,但别用 if (!Sentry.isInitialized()) 做条件判断——这个方法在 init 前永远返回 false,容易误判

数据库连接层没做 error 分类,重试策略全乱套

数据库报错五花八门,但很多应用统一 sleep(1000); retry(),结果网络超时重试 3 次,主键冲突也重试 3 次,最后数据重复写入。

  • PostgreSQL 常见错误码要拆开处理:23505(唯一约束)该返回 409,不该重试;08006(连接失败)才适合指数退避重连
  • 用 pg 时,错误对象有 err.code 和 err.severity 字段;用 mysql2 时看 err.sqlState;ORM 如 Prisma 则需检查 error.code(如 P2002 表示唯一键冲突)
  • 连接池本身有 acquireTimeoutMillis 和 idleTimeoutMillis,但这些只是资源等待超时,和 SQL 执行失败无关——后者必须靠 query 层的 try/catch 捕获
  • 别在事务里对可预期错误(如乐观锁失败)用 throw:应该 return { success: false, reason: 'version_mismatch' },让上层决定是重试还是降级

真正难的不是加几个 try 或配个 Sentry,而是每种错误类型都要对应到具体动作:记录、告警、降级、重试、拒绝、补偿……漏掉一类,线上就多一个深夜报警。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

332

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

540

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

391

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

306

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

718

2026.06.16

数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

4783

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

971

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1249

2024.02.23

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn