在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或系统服务管理工具做好日志的定期清理，双重保险更稳妥。
