Linux JS日志异常捕获与处理方法

在Linux环境下使用JavaScript（即Node.js）进行开发时，异常捕获与处理是一个无法回避的关键环节。虽然看似基础，但要让应用稳定运行、减少线上事故，其中涉及不少技巧。以下直接介绍硬核方法。

1. 异常捕获的基本方法

a. 使用 try...catch 语句

try...catch 是最基础且直接的异常捕获方式，专门应对同步代码中可能出现的异常。操作方法简洁：将可能出错的代码放入 try 块，然后在 catch 块中捕获错误信息。

try {// 可能抛出异常的代码throw new Error('出错了！');} catch (error) {// 处理异常console.error('捕获到异常:', error.message);}

b. 使用 async/await 和 try...catch

异步操作在现代开发中占据主流，async/await 配合 try...catch 是最优雅的写法。这种组合在发送 HTTP 请求时尤为实用——既能从 API 获取数据，又能避免网络波动或异常响应导致应用崩溃。

async function fetchData() {try {const response = await fetch('https://api.example.com/data');if (!response.ok) {throw new Error('网络响应不正常');}const data = await response.json();console.log(data);} catch (error) {console.error('获取数据时出错:', error.message);}}fetchData();

2. 全局异常处理

问题来了：那些未被 try...catch 覆盖的异常该如何处理？Node.js 提供了两层“最后防线”：uncaughtException 和 unhandledRejection。

a. 捕获未捕获的异常

process.on('uncaughtException', (err) => {console.error('未捕获的异常:', err.message);// 可在此进行日志记录、发送通知等操作process.exit(1); // 强制退出进程});

b. 捕获未处理的 Promise 拒绝

process.on('unhandledRejection', (reason, promise) => {console.error('未处理的Promise拒绝:', reason.message);// 可在此进行日志记录、发送通知等操作});

需要警惕的是：一旦这两个事件被触发，说明应用已进入不稳定状态。最佳实践是记录日志、保存现场，然后优雅退出，避免继续运行。

3. 使用第三方日志库

生产环境中不能仅依赖 console.error，需要结构化的日志来支持后续查询、统计和报警。此时 winston 和 pino 成为理想选择。

a. 使用 Winston

安装包：

npm install winston

配置灵活：

const winston = require('winston');const logger = winston.createLogger({level: 'info',format: winston.format.json(),transports: [new winston.transports.Console(),new winston.transports.File({ filename: 'error.log', level: 'error' }),new winston.transports.File({ filename: 'combined.log' })]});// 捕获未处理的异常process.on('uncaughtException', (err) => {logger.error('未捕获的异常:', err);process.exit(1);});// 捕获未处理的Promise拒绝process.on('unhandledRejection', (reason, promise) => {logger.error('未处理的Promise拒绝:', reason);});// 示例代码try {throw new Error('测试异常');} catch (error) {logger.error('捕获到异常:', error.message);}

b. 使用 Pino

Pino 以轻量和高性能著称，适合对速度有严格要求的场景：

npm install pino

const pino = require('pino');const logger = pino({level: 'info' // 默认级别});// 捕获未处理的异常process.on('uncaughtException', (err) => {logger.error(err);process.exit(1);});// 捕获未处理的Promise拒绝process.on('unhandledRejection', (reason) => {logger.error(reason);});// 示例代码(async () => {try {throw new Error('测试异常');} catch (error) {logger.error(error.message);}})();

4. 日志轮转（Log Rotation）

日志文件会随时间增大，需考虑文件大小管理。两个日志库均提供对应的轮转方案。

a. 使用 Winston 的 rotate 传输器

const { createLogger, format, transports } = require('winston');const { combine, timestamp, printf } = format;const myFormat = printf(({ level, message, timestamp }) => {return `${timestamp} ${level.toUpperCase()}: ${message}`;});const logger = createLogger({level: 'info',format: combine(timestamp(),myFormat),transports: [new transports.File({ filename: 'combined.log', maxsize: 200000, tailable: true }),new transports.File({ filename: 'error.log', maxsize: 200000, tailable: true })]});

b. 使用 Pino 的 pino-rotate

npm install pino-rotate

const pino = require('pino');const rotate = require('pino-rotate');const logger = pino({level: 'info'});// 配置日志轮转rotate({period: '1d', // 每天轮转一次path: 'logs/', // 日志文件存放目录limit: 7 // 保留最近7天的日志});// 将pino的默认传输器替换为带有轮转功能的传输器logger.info('这是一个带有轮转功能的日志信息');

5. 集成到应用中

关键点在于：上述策略并非孤立，需要融入应用的每个关键模块。以 Express 为例，全局错误处理中间件充当最后一道“降落伞”，它能捕获所有路由中逃逸的异常，并传递给 logger：

const express = require('express');const app = express();// 中间件配置app.use(express.json());// 路由示例app.get('/', (req, res) => {throw new Error('测试路由异常');});// 全局错误处理中间件app.use((err, req, res, next) => {logger.error(`请求出错: ${req.method} ${req.url}`, { error: err.message });res.status(500).send('服务器内部错误');});// 启动服务器const PORT = process.env.PORT || 3000;app.listen(PORT, () => {logger.info(`服务器正在运行在端口 ${PORT}`);});

6. 监控和报警

记录日志仅是第一步，关键是出现问题时第一时间发现。推荐以下常用组合：

• Prometheus + Grafana：监控应用性能指标，如响应时间、错误率。
• ELK Stack（Elasticsearch, Logstash, Kibana）：集中管理、可视化和搜索日志。
• Sentry、Bugsnag：针对实时错误跟踪和报警，使用户发现问题前就能获知异常。

结合上述全局处理与日志库，能确保 Node.js 应用在 Linux 环境中稳定运行。扎实的异常管理是生产级代码的基础门槛。

总结

在 Linux 环境下用 JavaScript 开发时，异常捕获不是可有可无的装饰，而是必须夯实的地基。将 try...catch、全局处理器、日志库、轮转策略和监控报警串联起来，才能构建一套完整的异常管理体系。虽然不花哨，但能有效减少系统崩溃和显性 bug，降低修复成本。这是一项值得投入时间扎实完成的工作。