linux nodejs日志为何不输出

在 Linux 上 Node.js 程序“日志不输出”是很常见的问题，通常不是 Node 本身没打日志，而是输出被重定向、缓冲、或进程方式导致你看不到。下面按最常见原因逐一说明。

一、最常见原因

1️⃣ 标准输出被重定向了

你可能是这样启动的：

node app.js > /dev/null 2>&1 &

或

nohup node app.js > out.log 2>&1 &

结果：

console.log 写到了文件
你却在终端看，当然“没输出”

✅ 解决：

tail -f out.log

2️⃣ 后台进程（daemon / systemd）不直接输出到终端

pm2
systemd
docker
nohup

这些环境：

stdout 不属于你的 shell
必须看对应日志系统

✅ 示例：

pm2 logs
journalctl -u your-service
docker logs container_id

3️⃣ 输出被缓冲（最容易踩坑）

Node.js 在非 TTY（非终端）环境下：

stdout 是 块缓冲
日志不会实时刷出

例如：

node app.js | tee log.txt

可能几秒甚至几分钟才看到一次日志。

✅ 解决方式：

使用 process.stdout.write
或强制 flush（较少用）
或改用日志库（推荐）

二、代码层面的原因

4️⃣ 日志根本没执行

检查：

console.log('start') // 是否真的运行到这里？

常见坑：

异步错误提前退出
代码在 if 里没进
端口占用直接 crash

✅ 调试：

node app.js

不要后台运行，直接看终端

5️⃣ 错误被吞了（try/catch / Promise）

async function main() {
  throw new Error('oops')
}
main()

如果你没：

process.on('unhandledRejection', e => {
  console.error(e)
})

错误可能“无声消失”。

三、日志库相关问题

6️⃣ 用了 winston / pino / log4js 但没配置 transport

例如 winston：

const logger = winston.createLogger({})
// 没加 transports，啥都不输出

✅ 正确示例：

winston.add(new winston.transports.Console())

四、systemd 特例（非常常见）

如果你用：

[Service]
ExecStart=/usr/bin/node /app/app.js

日志在：

journalctl -u your-service -f

而不是终端。

五、快速自查清单 ✅

请你按顺序确认：

是不是后台运行（& / nohup / pm2）
日志是否写到了文件
是不是非 TTY 导致缓冲
是否用了日志库但没配置输出
是否有未捕获异常

六、推荐做法（最佳实践）

✅ 直接使用日志库：

import pino from 'pino'
const logger = pino()
logger.info('server started')

✅ 不要依赖 console.log 做生产日志

如果你愿意，可以贴：

启动命令
运行环境（pm2 / docker / systemd）
日志相关代码

我可以直接帮你定位是哪一条原因。