<!-- Spring AOP 核心依賴 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>
<!-- FastJSON 用于參數(shù)序列化 -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.32</version>
</dependency>
<!-- Lombok 簡化日志開發(fā) -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

package com.xm.kite.ztc.common.aspect;

import com.alibaba.fastjson2.JSONObject;
import lombok.extern.slf4j.Slf4j;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.ArrayList;
import java.util.List;

/**
 * AOP統(tǒng)一日志處理切面
 * 自動打印Controller層接口：URL、方法名、入?yún)?、響應結(jié)果、執(zhí)行耗時
 * 支持慢接口告警配置
 */
@Slf4j
@Aspect
@Component
public class LoggerHandler {

    /**
     * 慢接口閾值（單位：毫秒）
     * 從配置文件讀取，默認2000ms（2秒）
     */
    @Value("${method-logger.elapsed-time:2000}")
    private Long loggerHandlerElapsedTimeMs;

    /**
     * 切點：匹配指定包下所有Controller的所有方法
     * 可根據(jù)項目包路徑靈活修改?。。?
     */
    @Pointcut("execution(* com.xm.kite.ztc..controller..*.*(..))")
    public void allControllerMethods() {
    }

    /**
     * 環(huán)繞通知：包裹目標接口，執(zhí)行前后統(tǒng)一處理日志
     */
    @Around("allControllerMethods()")
    public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable {
        // 1. 記錄接口開始時間
        long startTime = System.currentTimeMillis();

        // 2. 獲取Http請求對象，解析請求URL
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        HttpServletRequest request = attributes.getRequest();
        String requestUrl = request.getRequestURL().toString();

        // 3. 獲取當前接口的類、方法名
        Logger currentLogger = LoggerFactory.getLogger(joinPoint.getSignature().getDeclaringType());
        String methodName = joinPoint.getSignature().getName();

        // 4. 安全處理入?yún)ⅲ哼^濾HttpServletRequest/Response，避免序列化異常
        List<Object> safeArgs = new ArrayList<>();
        for (Object arg : joinPoint.getArgs()) {
            if (arg instanceof HttpServletRequest || arg instanceof HttpServletResponse) {
                safeArgs.add("[" + arg.getClass().getSimpleName() + "]");
            } else {
                safeArgs.add(arg);
            }
        }
        // 入?yún)⑿蛄谢癁镴SON
        String requestArgs = JSONObject.toJSONString(safeArgs);

        // 5. 打印【請求入?yún)ⅰ咳罩?
        currentLogger.info("請求開始 >>> url: {}, method: {}, args: {}", requestUrl, methodName, requestArgs);

        // 6. 執(zhí)行目標接口方法
        Object result = joinPoint.proceed();

        // 7. 計算接口耗時
        long elapsedTime = System.currentTimeMillis() - startTime;
        String responseResult = JSONObject.toJSONString(result);

        // 8. 分級打印【響應結(jié)果】日志：慢接口WARN告警，正常接口INFO打印
        if (elapsedTime > loggerHandlerElapsedTimeMs) {
            currentLogger.warn("請求結(jié)束【慢接口告警】>>> 閾值:{}ms, url: {}, method: {}, args: {}, result: {}, 耗時:{}ms",
                    loggerHandlerElapsedTimeMs, requestUrl, methodName, requestArgs, responseResult, elapsedTime);
        } else {
            currentLogger.info("請求結(jié)束 >>> url: {}, method: {}, args: {}, result: {}, 耗時:{}ms",
                    requestUrl, methodName, requestArgs, responseResult, elapsedTime);
        }

        return result;
    }
}

# 日志配置：慢接口閾值（單位：毫秒）
method-logger:
  elapsed-time: 1500  # 調(diào)整為1.5秒，根據(jù)項目需求修改

// 獲取請求方式
String requestMethod = request.getMethod();
// 獲取客戶端IP
String clientIp = request.getRemoteAddr();
// 日志中新增打印
currentLogger.info("url: {}, ip: {}, requestType: {}, method: {}, args: {}", 
        requestUrl, clientIp, requestMethod, methodName, requestArgs);

// 改造入?yún)⑦^濾邏輯，隱藏敏感字段
for (Object arg : safeArgs) {
    if (arg instanceof UserDTO) {
        UserDTO user = (UserDTO) arg;
        user.setPassword("***"); // 密碼脫敏
    }
}

// 新增配置開關(guān)
@Value("${method-logger.enabled:true}")
private boolean loggerEnabled;

// 環(huán)繞通知中判斷
@Around("allControllerMethods()")
public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable {
    if (!loggerEnabled) {
        return joinPoint.proceed(); // 關(guān)閉日志，直接執(zhí)行接口
    }
    // 原有日志邏輯...
}

// 示例1：只打印指定包下的接口
@Pointcut("execution(* com.xm.kite.ztc.user.controller..*.*(..))")
// 示例2：只打印帶有@GetMapping注解的方法
@Pointcut("@annotation(org.springframework.web.bind.annotation.GetMapping)")

// 直接刪除result參數(shù)，簡化日志
currentLogger.info("請求結(jié)束 >>> url: {}, 耗時:{}ms", requestUrl, elapsedTime);

# 正常接口
INFO  c.x.k.z.t.controller.UserController - 請求開始 >>> url: http://localhost:8080/user/get, method: getUser, args: {"id":1}
INFO  c.x.k.z.t.controller.UserController - 請求結(jié)束 >>> url: http://localhost:8080/user/get, method: getUser, args: {"id":1}, result: {"code":200,"data":{"name":"張三"}}, 耗時:12ms

# 慢接口告警
WARN  c.x.k.z.t.controller.OrderController - 請求結(jié)束【慢接口告警】>>> 閾值:2000ms, url: http://localhost:8080/order/list, method: getOrderList, args: {"page":1}, result: {...}, 耗時:2560ms