Express 项目环境搭建 -- 16. 日志

出问题时,日志是定位问题的第一手材料。console.log 适合临时调试,但不适合生产:没有级别、没有结构、无法按条件采集。这一篇用 pino 建立结构化的日志。

为什么选结构化日志

结构化日志(JSON)可以被日志系统直接解析、检索和告警,而纯文本需要额外解析。对 AI 助手来说,固定的日志字段也更容易被读取和分析。

基本用法

1
npm install pino
1
2
3
4
5
6
7
8
// src/utils/logger.js
const pino = require("pino");

const logger = pino({
level: process.env.LOG_LEVEL || "info"
});

module.exports = logger;
1
2
3
4
const logger = require("./utils/logger");

logger.info({ userId: 1 }, "user login");
// {"level":30,"time":1732176000000,"pid":123,"userId":1,"msg":"user login"}

日志级别从低到高为 trace、debug、info、warn、error、fatal,生产环境通常设为 info,排查问题时临时调到 debug。

记录每个请求

pino-http 提供请求日志中间件,自动记录方法、路径、状态码和耗时:

1
npm install pino-http
1
2
3
4
const pinoHttp = require("pino-http");
const logger = require("./utils/logger");

app.use(pinoHttp({ logger, autoLogging: true }));

请求处理中可以用 req.log 打业务日志,它会自动带上请求 id:

1
2
3
4
app.get("/api/v1/users/:id", function (req, res) {
req.log.info("query user");
res.json({});
});

开发环境可读性

生产输出 JSON,开发可以用 pino-pretty 格式化成彩色文本:

1
2
3
4
5
6
7
const logger = pino({
level: "info",
transport:
process.env.NODE_ENV === "development"
? { target: "pino-pretty" }
: undefined
});

不要记录敏感信息

密钥、token、密码、身份证号等不应进入日志。pino 提供 redact 直接丢弃字段:

1
2
3
4
5
6
const logger = pino({
redact: {
paths: ["req.headers.authorization", "password", "req.body.password"],
remove: true
}
});

日志与错误处理

错误日志应包含足够的上下文(谁、哪个请求、什么参数),再由错误处理中间件统一返回(见第 7 篇)。日志负责记录,响应负责告知,两者分工。

参考链接

系列导航


Express 项目环境搭建 -- 16. 日志
https://bubao.github.io/posts/4d5e6f7a.html
作者
一念
发布于
2026年11月21日
许可协议