Nodejs日志写入失败原因

Node.js 中日志写入失败通常不是单一原因，而是权限、路径、磁盘、并发、流状态、异常未捕获等综合问题。下面按最常见的场景 + 排查方法系统说明。

一、最常见原因汇总（快速对照）

二、路径与目录问题（最常见）

❌ 错误示例

fs.writeFileSync('./logs/app.log', 'hello');

如果 logs/ 目录不存在，会直接失败。

✅ 正确做法

const fs = require('fs');
const path = require('path');

const logPath = path.join(__dirname, 'logs/app.log');
fs.mkdirSync(path.dirname(logPath), { recursive: true });
fs.writeFileSync(logPath, 'hello');

✅ 一定要确保目录存在

三、权限问题（Linux / Docker 高发）

常见错误

EACCES: permission denied

排查方式

ls -l app.log
whoami
df -h

解决方案

• 修改权限

chmod 777 logs/

• 换可写目录

const os = require('os');
os.tmpdir(); // /tmp

四、磁盘空间不足（ENOSPC）

错误示例

ENOSPC: no space left on device

检查

df -h

✅ 常见于：

• Docker 容器
• 日志无限增长
• 没做日志轮转

五、文件被占用（Windows 常见）

• 文件被 Excel / 编辑器打开
• 另一个进程正在写

✅ 解决方案：

• 停止占用程序
• 使用追加模式

fs.createWriteStream('app.log', { flags: 'a' });

六、Stream 使用错误（最容易忽略）

❌ 错误

const ws = fs.createWriteStream('app.log');
ws.end();
ws.write('data'); // ❌ write after end

✅ 正确

ws.write('data\n');
ws.end();

或监听错误：

ws.on('error', err => {
  console.error('日志写入失败', err);
});

七、并发写同一文件（内容丢失 / 报错）

问题

多个请求同时写 app.log

解决方案

✅ 使用日志库

• winston
• pino

✅ 或加锁 / 队列（不推荐自己写）

八、日志库配置错误（winston / pino）

winston 示例

const winston = require('winston');

const logger = winston.createLogger({
  transports: [
    new winston.transports.File({
      filename: 'logs/app.log',
      level: 'info'
    })
  ]
});

常见错误

• filename 路径不存在
• 权限不足
• transport 未加载

✅ 建议：

logger.on('error', err => {
  console.error('winston error', err);
});

九、异常未捕获导致“看起来没写”

❌ 错误

fs.writeFile('a.log', data); // 错误被吞

✅ 正确

fs.writeFile('a.log', data, err => {
  if (err) console.error(err);
});

或：

try {
  await fs.promises.writeFile('a.log', data);
} catch (e) {
  console.error(e);
}

十、Docker / 容器环境

常见问题

• /var/log 不可写
• 容器重启日志丢失

✅ 建议：

• 挂载 volume

docker run -v $(pwd)/logs:/app/logs

• 或输出到 stdout

十一、快速排查清单（实战）

✅ 按这个顺序查：

1. 目录是否存在？
2. 是否有写权限？
3. 磁盘是否满？
4. 是否并发写？
5. 是否 stream 已关闭？
6. 是否未捕获错误？
7. 是否 Docker / 路径问题？

十二、如果你愿意，我可以进一步帮你

你可以直接贴：

• 报错信息（完整 error）
• 日志写入代码
• 是否使用 winston / pino
• 运行环境（Linux / Windows / Docker）

我可以精准定位是哪一类问题，并给你最小修复方案。