Node.js日志如何实现自动化处理

在日常的Node.js开发中，日志处理这件事，看似基础，却最容易被忽视。一旦线上出了故障，日志就是唯一的“黑匣子”——记录得好，问题定位分分钟；记录得乱，那就只能靠猜了。那么，怎么让日志从“手动记账”变成“自动化流水线”？下面这几个步骤，基本能覆盖大多数场景。

1. 挑一个趁手的日志库
   社区里比较成熟的选择有 winston、bunyan 和 pino。前两个功能全面、生态好，后者胜在性能极快。选哪个看团队偏好和项目规模，但核心诉求都是一样的——能灵活控制日志级别、格式和输出目的地。

2. 把配置做精细
   日志级别（error、warn、info、debug）要按环境区分：线上环境通常只记录 error 和 warn，开发环境可以开 verbose。格式方面，推荐 JSON 格式，方便后续被日志收集工具解析。输出目的地也不止一种——控制台、文件、数据库，甚至直接推送到远程日志中心，都可以通过配置一起搞定。

3. 在关键位置埋点
   记录日志不是“到处写”，而是要有策略。比如：
   - 每次请求开始和结束时记录耗时
   - 数据库查询异常时打 error 日志
   - 第三方接口调用失败时带上响应体与状态码
   这样，排查问题时才能知道“哪个环节出了事”。

4. 日志轮转，别让文件无限膨胀
   单文件日志一旦超过几个 GB，打开都费劲，更别说检索了。很多日志库内置了轮转机制（winston 的 winston-daily-rotate-file 插件就很常用），你可以设置按天切分、按大小切分，并保留最近 N 个文件。磁盘空间不是无限大的，这一步务必加上。

5. 过期日志自动清理
   轮转只解决了“切分”，没解决“删除”。可以使用系统 crontab 或 Node 下的 node-cron 定期跑一个清理脚本，删除超过保留天数的旧日志。这样日志文件夹就不会像某些同学的桌面色令人头疼。

6. 日志别只存不分析
   存下日志只是第一步，真正有价值的是从中发现规律和异常。推荐对接 ELK Stack（Elasticsearch + Logstash + Kibana）或者 Datadog/Sentry 这类平台，把日志转换成可视化的监控面板。错误率突然飙升、某个 API 响应变慢，一目了然。

下面用 winston 写一个简单的示例，你大概看一下整体结构就明白了：

const winston = require('winston');

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

logger.info('Hello, world!');
logger.error('An error occurred');

// 非生产环境下，也输出到控制台
if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({
    format: winston.format.simple()
  }));
}

这段代码做了三件事：创建 logger 实例，配置 error 级别的日志单独写入 error.log，其他日志写入 combined.log；然后通过 logger.info 和 logger.error 记录日志；最后判断如果是开发环境，加上控制台输出方便调试。你可以在这个基础上，再添加轮转、远程传输等插件，把日志体系从“能用”升级到“好用”。