使用morgan与rotating-file-stream时1d间隔日志轮转功能异常

数据老陈

2026-10-1

问题根源

你遇到的日志文件名和内容日期不匹配、轮转不符合预期的问题，核心是时区不一致和文件名生成逻辑不规范两个原因导致的：

日志内容里的日期是morgan默认输出的UTC时间（你可以看到每条日志末尾的+0000标识），但你生成文件名时用date-fns的format方法默认读取服务器本地时区的日期，两者时区偏差会导致日期差1天
你自定义的logFilename函数没有接收rotating-file-stream传入的轮转时间参数，而是自行创建new Date()取当前时间，极端情况下会出现毫秒级的跨天偏差，也可能导致文件名和轮转时间不匹配

修复方案

修改后的完整代码如下：

const morgan = require('morgan');
const rfs = require('rotating-file-stream');
const path = require('path');
// 引入formatUTC代替默认的format，统一用UTC时区生成文件名
const { formatUTC } = require('date-fns');

// 接收rfs传入的轮转时间参数，用该时间生成对应文件名
function logFilename(time) {
  const targetTime = time || new Date();
  return `${formatUTC(targetTime, 'yyyy-MM-dd')}-access.log`;
}

const accessLogStream = rfs.createStream(logFilename, {
  interval: '1d',
  path: path.resolve(__dirname, '..', 'log'),
  // 强制按UTC时区的天边界轮转，和日志内容的时区对齐
  utc: true,
  // 开启严格边界模式，确保轮转只在天的起始时刻触发
  boundary: true
});

morgan.token('ip', (req) => req.headers['x-forwarded-for'] || req.connection.remoteAddress);

morgan.token('user', (req) => {
  if (req.user) return req.user;
  return '-';
});

module.exports = morgan(':ip ":user" [:date[clf]] ":method :url HTTP/:http-version" :status :res[content-length] ":referrer" ":user-agent"', { stream: accessLogStream });