「简记往来」第二十篇：日志系统设计——没有日志，出了问题只能靠猜

2026/7/5 9:32:09

一、没有日志的代价

有一次，用户反馈“批量记礼功能用不了”。

我登录服务器，查了代码、查了数据库、查了网络……折腾了一个小时，才发现是MongoDB连接超时。

如果有日志，这个问题30秒就能定位。

没有日志，出了问题只能靠猜。

二、Node.js日志的基本原则

Node.js日志管理通常遵循**“应用层 + 系统层 + 运维层”三层结合的策略**。

核心原则：

使用结构化日志：采用JSON格式，便于检索和分析
分级记录：ERROR / WARN / INFO / DEBUG
包含上下文：requestId、userId、timestamp等
异步写入：不阻塞事件循环

三、日志库选型

Node.js生态推荐三个日志库：

库	特点	适用场景
Winston	功能最全、支持多传输	需要多种输出方式
Pino	性能最好、JSON原生	高并发场景
Bunyan	轻量、结构化	简单应用

简记往来使用Winston：

constwinston=require('winston');constlogger=winston.createLogger({level:process.env.LOG_LEVEL||'info',format:winston.format.combine(winston.format.timestamp(),winston.format.json()),transports:[newwinston.transports.File({filename:'logs/error.log',level:'error'}),newwinston.transports.File({filename:'logs/combined.log'})]});if(process.env.NODE_ENV!=='production'){logger.add(newwinston.transports.Console({format:winston.format.simple()}));}

四、日志分级

级别	用途	示例
ERROR	系统错误，需要立即处理	数据库连接失败
WARN	异常但可恢复	请求参数不完整，使用默认值
INFO	关键业务操作	用户登录、创建账本
DEBUG	调试信息	查询参数、中间件执行

生产环境建议将日志级别控制在WARN/ERROR，按需开启INFO/DEBUG。

五、日志格式规范

每条日志应包含：

{"timestamp":"2026-06-30T10:00:00.000Z","level":"INFO","service":"jianji-backend","requestId":"req_xxx","userId":"user_xxx","message":"用户登录成功","duration":125}

requestId是贯穿整个请求链路的唯一标识，方便追踪问题。

六、日志存储与轮转

日志文件需要定期轮转，防止磁盘占满：

constDailyRotateFile=require('winston-daily-rotate-file');consttransport=newDailyRotateFile({filename:'logs/application-%DATE%.log',datePattern:'YYYY-MM-DD',maxSize:'20m',maxFiles:'14d'});