如何使用Winston+winston-mysql实现MySQL日志存储？配置后无报错未入库

代码中存在的核心问题 #

• 插件初始化方式错误：winston-mysql 新版引入后会自动挂载到Winston的Transport列表下，直接将require返回值当作构造函数实例化，虽然不会抛出语法错误，但会导致Transport内部连接初始化逻辑失效，无法和MySQL建立持久连接。
• 字段映射逻辑完全错位：fields配置的键是Winston内置的日志字段名（level、message、meta、timestamp），值是对应MySQL日志表的列名。你当前的配置把所有映射值写成了固定字符串，既和你设计的表列名不匹配，也会导致插件找不到需要写入的目标列，写入时触发的SQL错误会被插件内部静默吞掉。
• 多余的构造器调用：winston.createLogger 是用于创建Logger实例的工厂方法，外层套new操作会导致返回的实例异常，无法正确绑定Transport，日志不会被实际发送到MySQL。
• 错误监听缺失：winston-mysql 默认不会将连接层、SQL执行层的错误抛到主进程，连接失败、SQL报错时只会把日志存在内存队列中，不会触发任何页面可见的报错，看起来就像程序正常运行。

修正后的可用代码 #

修正后的logger.js #

// 先加载环境变量，确保process.env中的数据库配置能被正确读取
require('dotenv').config();
const winston = require('winston');
// 引入插件完成Transport注册，不需要手动将require结果作为构造器
require('winston-mysql');

const dbConfig = {
  host: process.env.DB_HOST,
  user: process.env.DB_USER,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  table: 'log',
  // 正确的字段映射：Winston内置日志字段 -> 数据库表列名，按你实际的表列名调整即可
  fields: {
    level: 'level',
    message: 'message',
    meta: 'metadata',
    timestamp: 'addDate'
  },
  // 开启异常捕获，避免日志写入异常打断主业务
  handleExceptions: true
};

const logger = winston.createLogger({
  transports: [
    // 从Winston的Transport列表中取出Mysql构造器实例化
    new winston.transports.Mysql(dbConfig)
  ]
});

// 给每个Transport添加错误监听，把底层的连接、写入错误打印到控制台，避免静默失败
logger.transports.forEach(transport => {
  transport.on('error', (err) => {
    console.error('数据库日志写入失败:', err);
  });
});

module.exports = logger;

控制器中的调用调整 #

你在客户创建成功后的日志调用，可以补充传递结构化元数据，和配置中的meta字段对应：

// 替换原来的logger.log({level:'info',message : 'customer'})
logger.log({
  level: 'info',
  message: '客户创建成功',
  meta: {
    customerId: id,
    username: req.body.username,
    createTime: CurrentTime
  }
});

额外验证点 #

• 确认MySQL中log表的列结构和映射配置完全匹配，比如addDate是datetime类型、message列的长度足够存储日志内容，没有NOT NULL约束的列没有被漏配置。
• 服务启动后手动触发一次测试日志写入，检查控制台有没有打印“数据库日志写入失败”的提示，确认连接是否正常建立。
• 检查环境变量是否正确加载，避免因为DB_HOST等配置为undefined导致插件无法连接数据库。

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