Java 中怎么使用 Spring AOP 记录接口访问日志-java教程-PHP中文网

spring aop记录接口日志的核心是通过@aspect切面拦截controller层public方法，精准定义切入点、安全序列化参数与响应、脱敏敏感字段，并控制日志粒度以保障性能。

java 中怎么使用 spring aop 记录接口访问日志

在 Spring 项目中，用 AOP 记录接口访问日志，核心是通过切面（@Aspect）拦截控制器方法（如 @GetMapping、@PostMapping），在执行前后获取请求信息、参数、响应结果和耗时。关键在于精准定义切入点（Pointcut）、合理处理参数与异常，并避免敏感数据泄露。

定义切入点：只拦截 Controller 层的公开接口

使用 @Pointcut 匹配所有 @RestController 或 @Controller 中的 public 方法，推荐按注解匹配更清晰：

写法示例：@Pointcut("@within(org.springframework.web.bind.annotation.RestController) || @within(org.springframework.web.bind.annotation.Controller)")
再组合方法级注解（如 @GetMapping）可进一步缩小范围：@Pointcut("execution(* com.example..*Controller.*(..)) && @annotation(org.springframework.web.bind.annotation.RequestMapping) || @annotation(org.springframework.web.bind.annotation.GetMapping) || ...")
实际开发中建议统一用包路径 + 注解方式，例如：@Pointcut("execution(* com.example.web..*.*(..)) && @annotation(org.springframework.web.bind.annotation.RequestMapping)")

记录请求基本信息：时间、URI、HTTP 方法、IP 和用户标识

在 @Before 增强中，从 RequestContextHolder 获取当前请求上下文：

java-enterprise

Java企业开发专家，专注于Spring Boot、微服务架构和JVM优化。适用于：Java语言掌握、

下载

用 HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.currentRequestAttributes()).getRequest();
提取 request.getRequestURL().toString()、request.getMethod()、request.getRemoteAddr()
若已集成登录（如 Spring Security），可通过 SecurityContextHolder.getContext().getAuthentication().getName() 获取当前用户名
注意：不要直接打印完整请求体（如 JSON body），避免日志污染或泄露密码等敏感字段

记录参数与响应：安全地序列化非敏感内容

用 @Around 拦截整个方法执行流程，捕获入参、返回值和异常：

入参建议用 JSON.toJSONString(args, SerializerFeature.WriteMapNullValue)（FastJSON）或 ObjectMapper.writeValueAsString()（Jackson）转为字符串，但先过滤掉含 password、token、auth 等字段的对象
响应结果可在 proceed() 后获取，同样做脱敏处理；若返回值是 ResponseEntity 或自定义封装类（如 Result<t></t>），需解析其 data 字段再记录
捕获异常时，记录 throwable.getMessage() 即可，避免打印完整堆栈到业务日志（堆栈应进 error 日志文件）