Winston仅控制台输出日志但无法写入/追加至文件的问题排查

可能的原因 #

• 全局日志实例未共享：dizihub/index.ts和global/globalhelper.ts可能使用了不同的Winston实例，catch块调用的日志实例没配置File transport
• 异步写入未完成：程序触发错误后直接退出，Winston的异步文件写入还没完成就终止了
• 文件权限/路径错误：日志文件所在目录无读写权限，或者文件路径配置有误
• 日志级别不匹配：File transport的级别设置高于触发的日志级别，导致日志被过滤
• 配置项冲突：自定义的autoClose或flags配置和Winston内部逻辑冲突

排查与解决步骤 #

1. 统一全局日志实例 #

确保所有文件使用同一个带File transport的Winston实例，不要在不同文件中重复创建：

// global/logger.ts 全局日志实例
import winston from 'winston';

const logger = winston.createLogger({
  level: 'error',
  format: winston.format.json(),
  transports: [
    new winston.transports.File({ 
      filename: 'error.log',
      level: 'error'
    }),
    new winston.transports.Console({
      format: winston.format.combine(
        winston.format.colorize(),
        winston.format.simple()
      )
    })
  ]
});

export default logger;

在dizihub/index.ts和global/globalhelper.ts中都导入这个实例，确保catch块里用的是同一个logger。

2. 确保日志写入完成再退出 #

错误触发后，Winston的文件写入是异步的，直接退出会导致写入中断。在catch块中等待日志写入完成：

// dizihub/index.ts
import logger from '../global/logger';
import { compareDiffrencesArray } from '../global/globalhelper';

async function run() {
  try {
    compareDiffrencesArray();
  } catch (err) {
    logger.error('Error occurred:', err);
    // 等待日志写入完成后再退出
    await new Promise(resolve => logger.on('finish', resolve));
    process.exit(1);
  }
}

run();

也可以在Winston配置中添加exitOnError: false，避免程序自动退出。

3. 检查文件路径与权限 #

• 确认日志文件路径正确，用绝对路径测试：filename: path.join(__dirname, '../error.log')（需导入path模块）
• 检查目录权限：Linux/macOS下执行chmod 755 ./（项目根目录），Windows右键检查文件属性的读写权限
• 手动创建日志文件：touch error.log（Linux/macOS）或手动新建文件，测试程序能否写入

4. 验证日志级别配置 #

确保File transport的level不高于要记录的日志级别。比如要记录error级别的日志，File transport的level必须设为error或更低（如warn、info）：

new winston.transports.File({
  filename: 'error.log',
  level: 'error', // 确保error级日志被捕获
})

同时检查全局logger的level设置，不能高于File transport的level。

5. 简化配置排查冲突 #

暂时去掉autoClose和flags配置，用Winston默认配置测试：

new winston.transports.File({
  filename: 'error.log',
})

如果默认配置能写入，再逐步添加自定义配置，排查是否是flags: 'as+'或autoClose: false导致的问题。

验证方法 #

1. 运行程序触发错误
2. 检查日志文件是否生成内容
3. 查看控制台是否有文件操作相关的错误（如EACCES权限错误）
4. 手动调用logger.error('test')，测试File transport是否正常工作

内容的提问来源于stack exchange，提问作者Mehmet Yağız Maktav