Express 项目环境搭建 -- 16. 日志
出问题时,日志是定位问题的第一手材料。console.log 适合临时调试,但不适合生产:没有级别、没有结构、无法按条件采集。这一篇用 pino 建立结构化的日志。
为什么选结构化日志
结构化日志(JSON)可以被日志系统直接解析、检索和告警,而纯文本需要额外解析。对 AI 助手来说,固定的日志字段也更容易被读取和分析。
基本用法
1 | |
1 | |
1 | |
日志级别从低到高为 trace、debug、info、warn、error、fatal,生产环境通常设为 info,排查问题时临时调到 debug。
记录每个请求
pino-http 提供请求日志中间件,自动记录方法、路径、状态码和耗时:
1 | |
1 | |
请求处理中可以用 req.log 打业务日志,它会自动带上请求 id:
1 | |
开发环境可读性
生产输出 JSON,开发可以用 pino-pretty 格式化成彩色文本:
1 | |
不要记录敏感信息
密钥、token、密码、身份证号等不应进入日志。pino 提供 redact 直接丢弃字段:
1 | |
日志与错误处理
错误日志应包含足够的上下文(谁、哪个请求、什么参数),再由错误处理中间件统一返回(见第 7 篇)。日志负责记录,响应负责告知,两者分工。
参考链接
系列导航
Express 项目环境搭建 -- 16. 日志
https://bubao.github.io/posts/4d5e6f7a.html
