基于Java编写统一日志工具类搞定双日志体系的智能打印

package com.at.mrp.bll.log;
import com.xxl.job.core.context.XxlJobHelper;
import lombok.extern.slf4j.Slf4j;
import org.slf4j.Logger;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
/**
 * 统一日志工具类
 * 支持 slf4j 和 XxlJob 日志的智能过滤
 *
 * 使用方式：
 * 1. UAT/测试环境：在消息中包含【重要】、【错误】、【失败】等关键词才会输出
 * 2. 生产环境：所有日志都输出
 *
 * 示例：
 * UnifiedLogger.info(log, "【重要】开始执行批量任务");
 * UnifiedLogger.info(log, "普通调试信息"); // UAT环境不输出，生产环境输出
 * UnifiedLogger.error(log, "发生异常: {}", errorMsg); // 所有环境都输出
 */
@Slf4j
@Component
public class UnifiedLogger {
    private static String logEnv;
    @Value("${log.env:prod}")
    public void setLogEnv(String env) {
        UnifiedLogger.logEnv = env;
    }
    /**
     * 判断是否应该记录日志
     * UAT/测试环境：只记录包含特定关键词的日志
     * 生产环境：全部记录
     */
    private static boolean shouldLog(String message) {
        if ("prod".equalsIgnoreCase(logEnv)) {
            return true;
        }
        if (message == null || message.isEmpty()) {
            return false;
        }
        String upperMsg = message.toUpperCase();
        // UAT/测试环境：只记录包含以下关键词的日志
        return upperMsg.contains("【重要】")
                || upperMsg.contains("【错误】")
                || upperMsg.contains("【失败】")
                || upperMsg.contains("【警告】")
                || upperMsg.contains("【关键】")
                || upperMsg.contains("[ERROR]")
                || upperMsg.contains("[FAIL]")
                || upperMsg.contains("[WARN]")
                || upperMsg.contains("[IMPORTANT]");
    }
    // ==================== slf4j 日志方法 ====================
    /**
     * INFO 级别日志 - 智能过滤
     *
     * @param logger slf4j Logger 实例
     * @param message 日志消息
     * @param args 参数
     */
    public static void info(Logger logger, String message, Object... args) {
        if (shouldLog(message)) {
            logger.info(message, args);
        }
    }
    /**
     * WARN 级别日志 - 所有环境都记录（自动添加【警告】标记）
     *
     * @param logger slf4j Logger 实例
     * @param message 日志消息
     * @param args 参数
     */
    public static void warn(Logger logger, String message, Object... args) {
        String formattedMessage = "【警告】" + message;
        logger.warn(formattedMessage, args);
    }
    /**
     * ERROR 级别日志 - 所有环境都记录（自动添加【错误】标记）
     *
     * @param logger slf4j Logger 实例
     * @param message 日志消息
     * @param args 参数
     */
    public static void error(Logger logger, String message, Object... args) {
        String formattedMessage = "【错误】" + message;
        logger.error(formattedMessage, args);
    }
    /**
     * DEBUG 级别日志 - 仅生产环境记录
     *
     * @param logger slf4j Logger 实例
     * @param message 日志消息
     * @param args 参数
     */
    public static void debug(Logger logger, String message, Object... args) {
        if ("prod".equalsIgnoreCase(logEnv)) {
            logger.debug(message, args);
        }
    }
    // ==================== XxlJob 日志方法 ====================
    /**
     * XxlJob 智能日志记录
     * 根据环境和消息内容决定是否输出
     *
     * @param message 日志消息，可包含【重要】、【错误】等关键词
     * @param args 参数
     */
    public static void xxlLog(String message, Object... args) {
        if (shouldLog(message)) {
            XxlJobHelper.log(message, args);
        }
    }
    /**
     * XxlJob 错误日志（自动添加【错误】标记）
     */
    public static void xxlLogError(String message, Object... args) {
        String formattedMessage = "【错误】" + message;
        XxlJobHelper.log(formattedMessage, args);
    }
    /**
     * XxlJob 警告日志（自动添加【警告】标记）
     */
    public static void xxlLogWarn(String message, Object... args) {
        String formattedMessage = "【警告】" + message;
        XxlJobHelper.log(formattedMessage, args);
    }
    /**
     * XxlJob 重要日志（自动添加【重要】标记）
     */
    public static void xxlLogImportant(String message, Object... args) {
        String formattedMessage = "【重要】" + message;
        XxlJobHelper.log(formattedMessage, args);
    }
    /**
     * XxlJob 详细日志 - 仅生产环境记录
     */
    public static void xxlLogDetail(String message, Object... args) {
        if ("prod".equalsIgnoreCase(logEnv)) {
            XxlJobHelper.log(message, args);
        }
    }
}

log:
  env: uat

log:
  env: prod

@Slf4j
@Service
public class OrderService {

    public void syncOrder() {
        // 【重要日志】测试/生产环境都会打印
        UnifiedLogger.info(log, "【重要】开始同步订单，总数量：{}", orderCount);
        
        // 普通调试日志：测试环境不打印，生产环境打印
        UnifiedLogger.info(log, "订单详情参数：{}", JSON.toJSONString(order));
        
        // 错误日志：自动加【错误】标记，所有环境必打印
        UnifiedLogger.error(log, "订单同步失败：{}", e.getMessage());
        
        // 警告日志：自动加【警告】标记，所有环境必打印
        UnifiedLogger.warn(log, "订单库存不足，请及时处理");
    }
}

@XxlJob("batchTaskJob")
public void batchTask() {
    // 重要任务日志：全环境打印
    UnifiedLogger.xxlLog("【重要】定时任务开始执行");
    
    // 详细任务日志：仅生产环境打印
    UnifiedLogger.xxlLog("任务入参：{}", param);
    
    // 任务错误日志：全环境打印
    UnifiedLogger.xxlLogError("定时任务执行失败：{}", errorMsg);
}