为何Nodejs日志丢失数据

Node.js 日志**“丢失数据”通常不是 Node.js 本身故意丢，而是写入方式、进程生命周期、并发、缓冲区等综合问题**。下面按最常见原因 → 对应解决方案系统说明。

一、最常见原因（90% 都在这里）

1️⃣ 进程退出太快，日志还没写完（最常见）

Node.js 默认是异步非阻塞 I/O，日志往往还在缓冲区里，进程就退出了。

console.log('start');
process.exit(0);   // 日志可能没刷出去

✅ 解决方案

process.on('exit', () => {
  // 不要在这里写异步日志，exit 时已经太晚
});

// 正确方式：等日志写完再退出
setTimeout(() => {
  process.exit(0);
}, 100);

或使用：

process.exitCode = 0;

2️⃣ console.log 在 Docker / 容器里“丢日志”

console.log 输出到 stdout，但：

• Docker 日志驱动是异步
• stdout 是行缓冲
• 容器被 kill 时日志未 flush

✅ 解决方案

• 使用日志库（见下文）
• 或强制刷新 stdout：

process.stdout.write(JSON.stringify(log) + '\n');

3️⃣ 日志库未正确 flush（Winston / Pino / Bunyan）

很多日志库默认有 buffer，不会立刻写磁盘。

Winston 示例

new winston.transports.File({
  filename: 'app.log',
  // 默认有缓冲
})

✅ 解决方案

// 程序退出前
logger.end();

或：

logger.close();

4️⃣ 日志文件被覆盖 / 轮转问题

• 多进程写同一个日志文件
• 日志轮转（logrotate）截断文件
• PM2 cluster 模式并发写

✅ 解决方案

• 每个进程写独立文件
• 使用 append 模式
• 使用 pino + pino-rotating-file

5️⃣ 异常 / 崩溃导致日志丢失

未捕获异常时，Node.js 直接退出：

throw new Error('crash');

✅ 解决方案

process.on('uncaughtException', (err) => {
  logger.error(err);
  process.exit(1);
});

process.on('unhandledRejection', (err) => {
  logger.error(err);
});

⚠️ 注意：异常里尽量只做同步日志

6️⃣ 异步日志未 await

logger.info('xxx'); // 异步
res.send('ok');     // 先返回

✅ 解决方案

• 使用 同步日志（pino + 文件）
• 或确保日志完成再返回

二、不同日志方式对比（很重要）

✅ 推荐组合

Node.js + Pino + systemd / Docker json-file

三、Docker / 生产环境最佳实践

✅ 正确姿势

// 日志输出到 stdout
pino().info('hello');

Docker：

docker logs <container>

✅ 不要

• 在容器里写本地文件
• 多进程写同一个 log 文件

四、快速自检清单 ✅

你可以对照检查：

• [ ] 是否 process.exit 太早？
• [ ] 是否用 console.log 当正式日志？
• [ ] 是否有 uncaughtException？
• [ ] 日志库是否 flush？
• [ ] 是否多进程写同一文件？
• [ ] 是否在 Docker 里？

五、推荐你直接用的方案（省事）

✅ 最稳方案

import pino from 'pino';

const logger = pino({
  level: 'info',
});

logger.info('this will not be lost');

如果你愿意，可以把你现在的：

• 日志代码
• 是否在 Docker / PM2
• 是否 cluster 模式

贴出来，我可以直接帮你定位是哪一行在丢日志。