AOP与Filter拦截请求打印日志，哪种方式更高效且易维护？

在Java Web开发中，请求日志记录是监控应用行为、排查问题的重要手段，AOP（Aspect-Oriented Programming，面向切面编程）与Filter（过滤器）是两种主流的请求拦截技术，二者在实现日志打印时各有特点，适用于不同的场景，本文将从技术原理、实现方式、优缺点对比及适用场景等方面，详细分析AOP与Filter在请求日志打印中的应用。

Filter拦截请求打印日志的实现原理

Filter是Servlet规范中提供的一种技术,用于对请求进行预处理和后处理，当请求到达目标资源之前，Filter可以拦截请求并执行逻辑；在响应返回客户端之前，Filter也可以对响应进行处理，其核心是通过实现javax.servlet.Filter接口，并配置在web.xml或使用注解（如@WebFilter）来指定拦截的URL模式。

实现步骤：

1. 实现Filter接口：创建类并实现doFilter方法，该方法包含三个参数——ServletRequest、ServletResponse和FilterChain。
2. 前置处理：在调用chain.doFilter()之前，记录请求的URL、方法、参数等信息。
3. 后置处理：在chain.doFilter()之后，可记录响应状态码、耗时等数据。
4. 配置拦截路径：通过注解或XML配置Filter要拦截的URL模式，如表示拦截所有请求。

示例代码：

@WebFilter("/*")
public class LogFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
            throws IOException, ServletException {
        long startTime = System.currentTimeMillis();
        HttpServletRequest req = (HttpServletRequest) request;
        System.out.println("请求URL: " + req.getRequestURI() + ", 方法: " + req.getMethod());
        chain.doFilter(request, response);
        long endTime = System.currentTimeMillis();
        System.out.println("响应耗时: " + (endTime - startTime) + "ms");
    }
}

优点：

• 底层拦截：Filter在Servlet容器层面生效，可拦截所有HTTP请求，包括静态资源。
• 简单直接：无需额外依赖，基于Servlet规范实现，配置简单。

缺点：

• 耦合度高：与Servlet API强耦合，难以直接获取业务层方法信息。
• 灵活性不足：仅能获取请求和响应的基础信息，无法深入到方法调用层面。

AOP拦截请求打印日志的实现原理

AOP是一种编程范式,通过预编译方式或运行期代理实现程序功能的统一维护，在Spring框架中，AOP通过动态代理（JDK动态代理或CGLIB）为目标对象创建代理对象，在方法执行前后插入切面逻辑，实现日志打印时，通常通过@Aspect注解定义切面，并使用@Around、@Before等通知类型拦截方法调用。

实现步骤：

1. 定义切面：使用@Aspect注解标记切面类。
2. 配置切入点：通过@Pointcut定义拦截的方法，如execution(* com.example.controller..*(..))表示拦截controller包下的所有方法。
3. 编写通知：使用@Around通知获取方法执行前后的时间戳，计算耗时并打印日志；@Before可在方法执行前打印请求参数。

示例代码：

@Aspect
@Component
public class LogAspect {
    @Pointcut("execution(* com.example.controller..*(..))")
    public void controllerPointcut() {}
    @Around("controllerPointcut()")
    public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable {
        long startTime = System.currentTimeMillis();
        String className = joinPoint.getTarget().getClass().getName();
        String methodName = joinPoint.getSignature().getName();
        System.out.println("类名: " + className + ", 方法: " + methodName);
        Object result = joinPoint.proceed();
        long endTime = System.currentTimeMillis();
        System.out.println("方法执行耗时: " + (endTime - startTime) + "ms");
        return result;
    }
}

优点：

• 解耦性强：与业务逻辑分离，通过切面统一管理日志，避免侵入业务代码。
• 功能丰富：可获取方法参数、返回值、异常等详细信息，支持复杂的日志逻辑。

缺点：

• 依赖框架：需要依赖Spring等AOP框架，仅能拦截Spring管理的Bean。
• 无法拦截静态资源：AOP基于代理实现，无法直接拦截HTTP请求层面的静态资源访问。

AOP与Filter的对比分析

总结与建议

在请求日志打印的场景中,Filter与AOP的选择需根据具体需求决定：

• 优先选择Filter：若需要拦截所有HTTP请求（如记录接口访问频率、统计请求耗时），或需要处理非Spring管理的资源（如静态文件），Filter是更合适的选择。
• 优先选择AOP：若日志需要深入到业务方法层面（如记录特定方法的参数和返回值），或希望与Spring事务、缓存等功能整合，AOP能提供更灵活的支持。

实际项目中,二者可结合使用：通过Filter记录请求的基础信息（如IP、URL），通过AOP记录方法调用的详细日志，从而实现全方位的请求监控与问题排查，这种组合既能保证日志的完整性，又能兼顾系统的灵活性和可维护性。