Rollbar.js Node.js 接入实战Express 服务端错误追踪的 5 步配置法【免费下载链接】rollbar.jsError tracking and logging from Javascript to Rollbar项目地址: https://gitcode.com/gh_mirrors/ro/rollbar.jsRollbar.js 是一款专业的错误追踪与日志记录工具支持从浏览器到 Node.js 服务端的完整错误监控。本文面向新手手把手教你在 Express 应用中完成Rollbar.js 服务端错误追踪的 5 步接入快速定位线上 Bug、减少故障排查时间。为什么需要 Node.js 服务端错误追踪浏览器端的报错你看得见但服务端悄悄抛出的异常、未处理的 Promise 拒绝往往只会让用户看到500 错误却无人知晓原因。Rollbar.js 的核心能力包括跨平台同一套 SDK 覆盖 Node.js、React、Angular、Next.js 等前端与服务端场景自动错误分组相同错误自动聚合为一个 Item避免告警风暴遥测时间线Telemetry错误发生前后的面包屑事件还原故障现场请求上下文自动附加上报错误时自动携带 URL、请求头、IP 等信息便于复现服务端实现位于src/server/目录Express 专用中间件在src/server/middleware/rollbarExpressMiddleware.js。第 1 步一键安装 rollbar SDK在项目中执行 npm 安装仓库地址https://gitcode.com/gh_mirrors/ro/rollbar.jsnpm install --save rollbar如果你使用 yarn则执行yarn add rollbar。第 2 步初始化 Rollbar 实例并配置 Access Token在 Express 入口文件如server.js顶部初始化实例。accessToken填你在 Rollbar 控制台创建的POST Server Item Access Token服务端专用令牌const Rollbar require(rollbar); const rollbar Rollbar.init({ accessToken: POST_SERVER_ITEM_ACCESS_TOKEN, captureUncaught: true, captureUnhandledRejections: true, payload: { code_version: 1.0.0 }, });几个关键点environment默认读取NODE_ENV环境变量可区分 development / production服务端默认选项定义在src/server/defaults.js与src/server/rollbar.js的Rollbar.defaultOptions中例如默认开启 IP 捕获、敏感字段脱敏scrubFields、scrubHeaders第 3 步挂载 Express 错误处理中间件这是 Express 接入的核心一步。在所有路由之后挂载errorHandler()中间件app.get(/error, function (req, res) { throw new Error(Hello World); }); // 注意必须放在所有路由定义之后 app.use(rollbar.errorHandler());errorHandler()会拦截 Express 错误流自动将err连同request上下文一起上报然后再把错误交给后续中间件。实现见src/server/rollbar.js中的Rollbar.prototype.errorHandler。 官方完整示例可参考examples/universal-node/server.js该示例演示了服务端渲染 Express 错误捕获的全栈接入方式。第 4 步捕获未捕获异常与 Promise 拒绝在 Node.js 中最致命的往往不是路由里抛出的错误而是未被 try/catch 捕获的异常uncaughtException未被 catch 的 Promise 拒绝unhandledRejection初始化时开启两个开关即可全局接管const rollbar Rollbar.init({ accessToken: 你的TOKEN, captureUncaught: true, // 捕获未捕获异常 captureUnhandledRejections: true // 捕获未处理的 Promise 拒绝 });开启后任何逃逸出 Express 错误流的异常都会被 Rollbar 兜底上报避免静默失败。相关逻辑在setupUnhandledCapture、handleUncaughtExceptions方法中实现。第 5 步验证上报效果与进阶配置启动服务后访问会抛错的接口如/error即可在 Rollbar 控制台看到新的错误 Item包含堆栈、请求 URL、主机名等信息。常用进阶配置配置项说明payload.code_version附带代码版本方便定位是哪次发布引入的错误environment环境标识默认取NODE_ENVreportLevel最低上报级别控制噪音ignoreDuplicateErrors默认开启忽略重复错误autoInstrument开启后自动采集 HTTP/fetch 请求日志和 console 日志作为遥测数据expressMiddleware()配合 Session Replay 的会话 ID 透传中间件 开启autoInstrument后SDK 会自动包装http.request、https.request、fetch以及process.stdout/stderr把出站请求和日志都记录为遥测事件实现见src/server/telemetry.js。这样排查问题时你能看到错误发生前服务调用了哪些下游接口、返回了什么状态码。常见问题速查错误没上报检查enabled、transmit是否为true以及accessToken是否使用了 Server Token 而非 Client Token测试环境想静音设置enabled: false或调高reportLevel敏感数据泄露默认的scrubFields/scrubHeaders已脱敏常见敏感字段如password、Authorization可按需扩充Lambda 场景使用rollbar.lambdaHandler(handler)包装处理函数还能捕获超时错误小结只需 5 步——安装 SDK → 初始化配置 → 挂载 Express 错误中间件 → 开启全局异常捕获 → 验证与进阶调优就能让你的 Express 应用具备专业的服务端错误追踪能力。配合 Rollbar 控制台的自动分组、遥测时间线和告警通知团队协作排查线上问题将事半功倍。更多框架示例React、Angular、Next.js 等可在仓库examples/目录中按需参考。【免费下载链接】rollbar.jsError tracking and logging from Javascript to Rollbar项目地址: https://gitcode.com/gh_mirrors/ro/rollbar.js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考