为什么nodejs日志不输出

Node.js 日志“不输出”是一个比较常见的问题，原因通常和运行方式、日志级别、输出目标、异步缓冲、框架配置有关。下面按常见原因逐一说明，并给出排查方法。

一、最基础：你用的是 console.log 还是日志库？

1️⃣ 使用了 console.log 但没看到

常见原因：

• 程序提前退出

console.log('start');
process.exit(0); // 日志可能来不及 flush

✅ 解决：去掉 process.exit，或用 process.exitCode

• 在异步代码里，但主线程已结束

setTimeout(() => {
  console.log('hello');
}, 1000);
// 如果没有其他事件循环，可能已退出

二、日志被“吃掉”了（输出目标不对）

2️⃣ 日志输出到了 stderr 而不是 stdout

console.error('error log');

• console.log → stdout
• console.error → stderr

✅ 检查方式：

node app.js 1>/dev/null   # 只看 stderr
node app.js 2>/dev/null   # 只看 stdout

三、使用了日志库但没配置（Winston / Pino / Log4js）

3️⃣ Winston 没加 transport

const winston = require('winston');
const logger = winston.createLogger({}); // ❌ 没 transport
logger.info('test'); // 不会输出

✅ 正确：

winston.createLogger({
  transports: [new winston.transports.Console()]
});

四、日志级别被过滤了

4️⃣ 日志级别设置太高

logger.level = 'error';
logger.info('debug info'); // ❌ 不输出

✅ 级别顺序（从低到高）：

debug < info < warn < error

五、Docker / PM2 / 生产环境影响

5️⃣ Docker 中日志不显示

• 使用了 console.log 但被缓冲
• 非 TTY 环境 stdout 有缓冲

✅ 解决：

node -e "setInterval(()=>console.log('alive'),1000)"

或在 Dockerfile：

ENV NODE_ENV=production

PM2 用户：

pm2 logs

六、代码抛错导致没执行到日志

6️⃣ 前面报错中断

const x = y + 1; // ReferenceError
console.log('never run');

✅ 解决：

node app.js

看是否有报错堆栈

七、被某些框架“劫持”了日志

常见框架问题

• NestJS：需用 Logger
• Express + Morgan：请求日志由 morgan 控制
• Next.js：server 端日志才可见

八、快速自查清单 ✅

你可以按顺序排查：

1. 用 console.log('test') 最前面测试
2. 确认程序没提前退出
3. 确认不是 stderr
4. 确认日志库有 transport
5. 确认日志级别
6. 在本地直接 node app.js 运行

如果你愿意，可以把：

• 使用的框架（Express / Nest / 原生）
• 日志方式（console / winston / pino）
• 运行环境（本地 / Docker / PM2）

发出来，我可以帮你精准定位是哪一条原因。