泄露敏感数据被安全合规部门请喝茶？在 winston/zap 后端日志中实现敏感数据（手机号/银行卡）的正则脱敏管线

import winston from 'winston';

// 定义敏感信息的正则匹配规则
const MASK_PATTERNS = {
  // 手机号：匹配 1 开头的 11 位数字，脱敏中间 4 位
  phone: /(?:^|\D)(1[3-9]\d{9})(?:\D|$)/g,
  // 身份证：匹配 18 位数字（最后一位可能为 X），脱敏中间 8 位
  idCard: /(?:^|\D)([1-9]\d{5}[19|20]\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])\d{3}[\dX])(?:\D|$)/gi,
  // 银行卡号：匹配 16 到 19 位连续数字，只保留前 6 后 4
  bankCard: /(?:^|\D)([1-9]\d{15,18})(?:\D|$)/g
};

/**
 * 递归遍历对象，对所有字符串字段以及 log 消息文本进行脱敏替换
 */
function maskSensitiveInfo(value: any): any {
  if (value === null || value === undefined) {
    return value;
  }

  if (typeof value === 'string') {
    let masked = value;

    // 1. 脱敏手机号
    masked = masked.replace(MASK_PATTERNS.phone, (match, p1) => {
      const maskedPhone = p1.replace(/^(\d{3})\d{4}(\d{4})$/, '$1****$2');
      return match.replace(p1, maskedPhone);
    });

    // 2. 脱敏身份证
    masked = masked.replace(MASK_PATTERNS.idCard, (match, p1) => {
      const maskedId = p1.replace(/^(\d{6})\d{8}(\d{4}|\d{3}[\dX])$/i, '$1********$2');
      return match.replace(p1, maskedId);
    });

    // 3. 脱敏银行卡号
    masked = masked.replace(MASK_PATTERNS.bankCard, (match, p1) => {
      const len = p1.length;
      const maskedCard = p1.substring(0, 6) + '*'.repeat(len - 10) + p1.substring(len - 4);
      return match.replace(p1, maskedCard);
    });

    return masked;
  }

  if (Array.isArray(value)) {
    return value.map(item => maskSensitiveInfo(item));
  }

  if (typeof value === 'object') {
    const maskedObj: Record<string, any> = {};
    for (const key of Object.keys(value)) {
      // 过滤键名也包含敏感特征的特定对象属性（可选）
      maskedObj[key] = maskSensitiveInfo(value[key]);
    }
    return maskedObj;
  }

  return value;
}

// 自定义 winston 脱敏格式化插件
const maskFormat = winston.format((info) => {
  // 复制一份，防止污染或改变原始的请求上下文对象
  const newInfo = JSON.parse(JSON.stringify(info));

  // 递归脱敏日志对象中的所有字段，包括 message
  newInfo.message = maskSensitiveInfo(newInfo.message);

  // 同样对 meta 数据等附属属性进行脱敏
  for (const key of Object.keys(newInfo)) {
    if (key !== 'level' && key !== 'timestamp' && key !== 'message') {
      newInfo[key] = maskSensitiveInfo(newInfo[key]);
    }
  }

  return newInfo;
});

// 构建 Winston Logger 实例
export const logger = winston.createLogger({
  level: 'info',
  format: winston.format.combine(
    winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss.SSS' }),
    maskFormat(), // 注入脱敏管线
    winston.format.json()
  ),
  transports: [
    new winston.transports.Console()
  ]
});