一、没有日志的代价有一次用户反馈“批量记礼功能用不了”。我登录服务器查了代码、查了数据库、查了网络……折腾了一个小时才发现是MongoDB连接超时。如果有日志这个问题30秒就能定位。没有日志出了问题只能靠猜。二、Node.js日志的基本原则Node.js日志管理通常遵循**“应用层 系统层 运维层”三层结合的策略**。核心原则使用结构化日志采用JSON格式便于检索和分析分级记录ERROR / WARN / INFO / DEBUG包含上下文requestId、userId、timestamp等异步写入不阻塞事件循环三、日志库选型Node.js生态推荐三个日志库库特点适用场景Winston功能最全、支持多传输需要多种输出方式Pino性能最好、JSON原生高并发场景Bunyan轻量、结构化简单应用简记往来使用Winstonconstwinstonrequire(winston);constloggerwinston.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是贯穿整个请求链路的唯一标识方便追踪问题。六、日志存储与轮转日志文件需要定期轮转防止磁盘占满constDailyRotateFilerequire(winston-daily-rotate-file);consttransportnewDailyRotateFile({filename:logs/application-%DATE%.log,datePattern:YYYY-MM-DD,maxSize:20m,maxFiles:14d});七、总结日志系统是运维的“眼睛”。用Winston/Pino记录结构化日志按ERROR/WARN/INFO/DEBUG分级包含requestId、userId、timestamp等上下文定期轮转防止磁盘占满没有日志出了问题只能靠猜。有了日志一切都有迹可循。下一篇我们来聊聊数据备份与恢复策略——数据丢了怎么办评论区聊聊你的日志系统是怎么设计的
