Debian上Node.js日志格式设置方法

在Debian环境下调整Node.js应用的日志格式，虽然难度不高，但要做到顺手且易于维护，仍需遵循正确的流程。以下详细分解各个步骤。

• 选择合适的日志库：当前社区常用的日志库包括 winston、morgan、pino 等，可根据项目需求自行选择。
• 安装日志库：使用 npm 或 yarn 进行安装，例如安装 winston 的命令为：

npm install winston

• 配置日志格式：不同日志库的配置方式有所差异，下面以 winston 和 morgan 为例分别说明。

使用Winston

winston 具有较高的灵活性，支持自定义日志格式。例如，希望输出包含时间戳和级别的日志：

const winston = require('winston');
const logger = winston.createLogger({
    level: 'info',
    format: winston.format.combine(
        winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
        winston.format.printf(({ timestamp, level, message }) => {
            return `${timestamp} ${level}: ${message}`;
        })
    ),
    transports: [
        new winston.transports.Console(),
        new winston.transports.File({ filename: 'error.log', level: 'error' }),
        new winston.transports.File({ filename: 'combined.log' })
    ]
});

// 使用示例
logger.info('Hello, world!');

使用Morgan

morgan 是 Express 应用中常用的 HTTP 请求日志中间件。可通过以下方式自定义日志格式：

const express = require('express');
const morgan = require('morgan');
const app = express();

// 自定义格式
morgan.token('customFormat', (req, res) => {
    return `${req.method} ${req.url} - ${res.statusCode}`;
});

app.use(morgan('customFormat'));

app.get('/', (req, res) => {
    res.send('Hello, world!');
});

app.listen(3000, () => {
    console.log('Server is running on port 3000');
});

将配置独立管理

在实际项目中，日志配置通常不与主逻辑耦合。更合理的做法是单独创建 logger.js 文件，例如基于 winston：

// logger.js
const winston = require('winston');
const logger = winston.createLogger({
    level: 'info',
    format: winston.format.combine(
        winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
        winston.format.printf(({ timestamp, level, message }) => {
            return `${timestamp} ${level}: ${message}`;
        })
    ),
    transports: [
        new winston.transports.Console(),
        new winston.transports.File({ filename: 'error.log', level: 'error' }),
        new winston.transports.File({ filename: 'combined.log' })
    ]
});
module.exports = logger;

然后在主应用中引入并使用：

// app.js
const express = require('express');
const logger = require('./logger');
const app = express();

app.use(morgan('customFormat'));

app.get('/', (req, res) => {
    logger.info('Hello, world!');
    res.send('Hello, world!');
});

app.listen(3000, () => {
    logger.info('Server is running on port 3000');
});

采用这种结构后，日后如需调整日志格式、新增传输通道或更换日志库，都无需改动主应用代码，维护成本显著降低。