log4js-node日志框架全面解析：从入门到精通-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00421/article/details/148488784

log4js-node日志框架全面解析：从入门到精通

log4js-node 项目地址: https://gitcode.com/gh_mirrors/log/log4js-node

什么是log4js-node

log4js-node是一个专为Node.js环境设计的高性能日志记录框架，它源自log4js项目，经过深度改造和优化后形成了独立的Node.js版本。虽然名称上与Java生态中著名的log4j相似，但两者在实现和使用方式上存在显著差异，开发者应当注意区分。

核心特性深度剖析

1. 多类型日志输出支持

log4js-node提供了丰富的日志输出方式（Appenders）：

控制台输出：支持彩色日志输出，可定向到stdout或stderr
文件输出：
- 基础文件记录
- 基于文件大小的滚动记录
- 基于日期的滚动记录（每日/每小时等）
网络传输：
- TCP日志传输（适用于集中式日志收集）
- UDP协议传输
- HTTP协议传输
云服务集成：
- Loggly云日志服务
- Logstash日志收集系统
- GELF格式（Graylog专用）
- InfluxDB时序数据库

2. 高级功能特性

分级日志控制：支持TRACE、DEBUG、INFO、WARN、ERROR、FATAL等标准级别
分类日志管理：可为不同模块设置不同的日志级别
集群支持：完美适配Node.js集群模式
Express中间件：提供专门的connect-logger用于Web请求日志
灵活布局：支持自定义日志格式和模式

安装与基础使用

安装方法

通过npm包管理器一键安装：

npm install log4js

基础示例

const log4js = require('log4js');
const logger = log4js.getLogger();

// 设置日志级别（默认为OFF）
logger.level = 'debug';

// 记录不同级别日志
logger.trace('追踪信息');
logger.debug('调试信息');
logger.info('普通信息');
logger.warn('警告信息');
logger.error('错误信息');
logger.fatal('致命错误');

版本迁移指南

从1.x或更早版本升级时需注意：

配置格式变化：新版采用了更简洁的JSON配置风格
API调整：部分方法签名和参数发生了变化
功能增强：新增了许多实用特性

建议升级前详细阅读官方迁移文档，进行充分测试后再部署到生产环境。

高级配置示例

log4js.configure({
  appenders: {
    out: { type: 'stdout' },
    file: { 
      type: 'dateFile',
      filename: 'application.log',
      pattern: '.yyyy-MM-dd'
    }
  },
  categories: {
    default: { appenders: ['out', 'file'], level: 'info' },
    database: { appenders: ['file'], level: 'debug' }
  }
});

// 获取分类logger
const dbLogger = log4js.getLogger('database');
dbLogger.debug('SQL查询执行...');