Debian环境下Node.js运行JS脚本报错：log4js配置异常求助

这个问题我之前帮不少开发者排查过，核心原因是log4js版本不兼容导致的配置格式冲突——你写的是log4js v1.x的旧配置逻辑，但当前安装的是v2+版本，这两个版本的配置结构差异很大。

错误原因拆解 #

你的配置是典型的v1.x格式：

{ 
  appenders: [ 
    { type: 'console' }, 
    { type: 'file', filename: 'logs/site.log' } 
  ] 
}

而log4js v2+要求appenders必须是对象类型，同时需要通过categories字段明确指定哪些appender生效，这就是报错提示“must have a property "appenders" type object”的直接原因。

两种解决方案 #

方案1：适配v2+版本，修改配置格式

把你的log4js配置改成v2+的标准写法，示例如下：

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

// 先确保logs目录存在，避免文件写入失败
const logDir = './logs';
if (!fs.existsSync(logDir)) {
  fs.mkdirSync(logDir);
}

// v2+版本的配置结构
log4js.configure({
  appenders: {
    // 给每个appender设置唯一标识
    consoleLogger: { type: 'console' },
    fileLogger: { type: 'file', filename: 'logs/site.log' }
  },
  categories: {
    // default是默认日志分类，指定启用的appender和日志级别
    default: { appenders: ['consoleLogger', 'fileLogger'], level: 'info' }
  }
});

// 调用日志示例
const logger = log4js.getLogger();
logger.info('测试日志输出');

方案2：降级log4js到v1.x版本，保留旧配置

如果你不想改动现有代码，可以直接把log4js降级到v1.x系列，这样旧的数组格式配置就能正常运行：

# 卸载当前版本
npm uninstall log4js
# 安装v1.x最新稳定版
npm install log4js@1.x --save

内容的提问来源于stack exchange，提问作者user9407009