Ubuntu系统Node.js日志输出配置方法

在Ubuntu环境下运行Node.js应用，日志配置是开发者必须面对的核心环节。许多人在初期习惯用console.log临时应付，但一旦应用部署到生产环境，日志管理便成为刚性需求——不仅要能完整记录，还必须便于故障排查、实现日志轮转与归档。下面从最基础的方案讲起，逐步深入至工业级实践。

使用内置的console模块

Node.js自带的console模块是最简单、最易上手的日志输出方式。直接调用console.log、console.error即可将信息输出到标准输出流和错误流。以下是一个典型的Express示例：

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

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

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

这种方案适用于快速原型开发或本地调试阶段，但一旦需要更精细的控制——比如按日志级别分类记录、输出到文件、实现日志轮转——就必须引入专门的第三方日志库了。

使用第三方日志库

Winston

winston 是目前Node.js社区最成熟、最流行的日志库之一，支持多种传输通道（控制台、文件、HTTP等），配置灵活且扩展性强。首先安装：

npm install winston

然后创建一个logger实例，根据运行环境动态调整输出方式：

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

// 创建logger实例
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

// 非生产环境额外输出到控制台（带简单格式）
if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({
    format: winston.format.simple()
  }));
}

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

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

上述配置将错误日志单独写入error.log，所有日志汇总至combined.log，同时控制台也会同步输出。这样既不影响生产环境性能，又能保留开发阶段的调试可见性。

Morgan

如果使用Express框架，morgan 是专为HTTP请求日志设计的中间件，开箱即用。安装：

npm install morgan

挂载到Express应用后，它能自动记录每个请求的详细信息：

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

// 使用'combined'格式（Apache风格）
app.use(morgan('combined'));

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

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

morgan 提供多种输出格式，如dev、short、combined，可根据实际场景灵活切换。它和winston可以配合使用——用morgan记录请求链路，用winston记录应用内部事件，实现互补。

配置日志轮转

日志文件如果不做轮转，长期运行会迅速占满磁盘空间。好在winston生态提供了专门的轮转插件——winston-daily-rotate-file。安装：

npm install winston-daily-rotate-file

配置时，指定文件名模板、日期格式、最大文件大小和保留天数，即可自动按小时/天切分文件，并压缩历史日志：

const express = require('express');
const winston = require('winston');
const { createLogger, format, transports } = winston;
const DailyRotateFile = require('winston-daily-rotate-file');
const app = express();

// 创建logger实例
const logger = createLogger({
  level: 'info',
  format: format.combine(
    format.timestamp(),
    format.json()
  ),
  transports: [
    new transports.Console(),
    new DailyRotateFile({
      filename: 'application-%DATE%.log',
      datePattern: 'YYYY-MM-DD-HH',
      zippedArchive: true,
      maxSize: '20m',
      maxFiles: '14d'
    })
  ]
});

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

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

关键参数说明：datePattern 设为小时级别，每小时的日志独立成文件；maxSize 限制单个文件20MB，超出后自动切分；maxFiles 保留14天，过期日志自动清理，同时开启zippedArchive压缩归档。这样既能保证磁盘空间可控，又方便按时间范围检索日志。

以上几种方法覆盖了从简单到复杂的Node.js日志配置场景。在实际生产环境中，推荐组合使用winston+morgan+日志轮转，既能捕获应用内部异常，又能完整记录HTTP请求链路。配置完成后，别忘记在Ubuntu上利用logrotate或系统服务管理工具做好日志的定期清理，双重保险更稳妥。