1.说明

Spring Boot微服务对外开放的Restful接口，
为了方便定位问题，
一般需要记录请求日志和响应日志，
而在每个接口中开发日志代码是非常繁琐的，
本文介绍使用Spring的切面AOP，
统一打印接口中的请求和响应日志，
也可以捕获异常，打印异常日志，
让接口的代码实现更加简洁，
同时也方便后期修改。

下面基于开发好Restful接口的微服务：
SpringBoot开发Restful接口
添加AOP切面打印日志功能。

2.添加切面依赖

修改pom.xml文件,
增加spring-boot-starter-aop切面依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

如果使用的是Log4j2日志框架，
需要移除默认的Logback依赖。

<!-- Log4j2 日志框架 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>
<!-- Spring Boot Web服务 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- Spring Boot Aop切面 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3.新建切面类

新建切面类WebLogAspect.java:

package com.yuwen.spring.demo.aspect;

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.stereotype.Component;

/**
 * Restful接口日志切面，用于打印请求日志和响应日志
 */
@Component
@Aspect
public class WebLogAspect {
    private Logger logger = LoggerFactory.getLogger(getClass());

    @Pointcut("execution(public * com.yuwen.spring.demo.controller.*.*(..))")
    public void webLog() {
    }

    @Around("webLog()")
    public Object around(ProceedingJoinPoint point) throws Throwable {

        String methodName = point.getSignature().toShortString();

        Object[] params = point.getArgs();

        if (logger.isDebugEnabled()) {
            logger.debug("{} start, request={}", methodName, params);
        }

        Object result;
        try {
            result = point.proceed();
        } catch (Exception e) {
            logger.error("{} error, exception={}", methodName, e);
            throw e;
        }

        if (logger.isDebugEnabled()) {
            logger.debug("{} end, result={}", methodName, result);
        }
        return result;

    }
}

注意修改切点，
配置为需要打印请求和响应日志的接口，
这里配置的是com.yuwen.spring.demo.controller包下的所有类的所有方法，
微服务运行后，匹配到的方法都会打印日志：

@Pointcut("execution(public * com.yuwen.spring.demo.controller.*.*(..))")

4.打印日志

启动Spring Boot服务，
然后随便调用几个Rest接口，
比如创建用户，
切面打印日志效果如下：

17:34:38.888 [http-nio-8088-exec-1] DEBUG [com.yuwen.spring.demo.aspect.WebLogAspect.around(WebLogAspect.java:34)] - UserControllerImpl.createUser(..) start, request=[User [id=1, name=tom, birthday=Thu Mar 25 17:21:45 GMT+08:00 2021, email=tom@ai.com]]
createUser, user=User [id=1, name=tom, birthday=Thu Mar 25 17:21:45 GMT+08:00 2021, email=tom@ai.com]
17:34:38.899 [http-nio-8088-exec-1] DEBUG [com.yuwen.spring.demo.aspect.WebLogAspect.around(WebLogAspect.java:46)] - UserControllerImpl.createUser(..) end, result=null

第1条日志对应接口请求，
第2条日志是创建用户的接口自己打印的，
第3条日志对应响应日志。
另外如果发生异常，
也会打印异常日志。

5.问题解决

如果微服务不打印日志，
可以参考：
SpringBoot集成Log4j2框架