Spring AOP实战：如何优雅地获取请求参数并实现统一处理

1次阅读

没有评论

共计 2267 个字符，预计需要花费 6 分钟才能阅读完成。

在日常 Web 开发中，我们经常遇到这些场景：

需要对所有接口的入参进行非空校验或格式校验
要记录关键接口的请求参数日志
某些敏感接口需要做参数解密
需要统计接口调用时传递的特定参数

如果每个接口都手动实现这些逻辑，会导致大量重复代码，维护困难。而 AOP 可以完美解决这个问题。

拦截器 (Interceptor)：更适合处理与 HTTP 协议直接相关的操作，如：
请求头处理
跨域设置
全局的权限检查
请求 / 响应数据转换
AOP：更适合业务层面的统一处理，如：
方法级的参数校验
业务日志记录
特定注解的解析
方法执行时间监控

选择 AOP 的主要原因是它可以直接获取方法参数，而拦截器只能获取到 HttpServletRequest 对象。

@Aspect
@Component
public class RequestParamAspect {

    // 定义切点：拦截所有 Controller 方法
    @Pointcut("execution(* com.example.controller..*.*(..))")
    public void controllerPointcut() {}

    @Around("controllerPointcut()")
    public Object around(ProceedingJoinPoint joinPoint) throws Throwable {
        // 获取方法签名
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method method = signature.getMethod();

        // 获取方法参数名和值
        String[] paramNames = signature.getParameterNames();
        Object[] args = joinPoint.getArgs();

        // 打印请求参数
        for (int i = 0; i < paramNames.length; i++) {log.info("参数名: {}, 参数值: {}", paramNames[i], args[i]);
        }

        // 执行原方法
        return joinPoint.proceed();}
}

// 获取方法上的注解
GetMapping getMapping = method.getAnnotation(GetMapping.class);
PostMapping postMapping = method.getAnnotation(PostMapping.class);

// 获取参数上的注解
Annotation[][] parameterAnnotations = method.getParameterAnnotations();
for (int i = 0; i < parameterAnnotations.length; i++) {for (Annotation annotation : parameterAnnotations[i]) {if (annotation instanceof RequestParam) {RequestParam requestParam = (RequestParam) annotation;
            String paramName = requestParam.value();
            // 处理 @RequestParam 注解的参数
        }
    }
}

// 在 around 方法中添加校验逻辑
for (int i = 0; i < args.length; i++) {if (args[i] == null) {throw new IllegalArgumentException(paramNames[i] + "不能为 null");
    }
    if (args[i] instanceof String && StringUtils.isEmpty((String) args[i])) {throw new IllegalArgumentException(paramNames[i] + "不能为空字符串");
    }
}

try {return joinPoint.proceed();
} catch (IllegalArgumentException e) {
    // 参数校验异常
    return Result.fail(400, e.getMessage());
} catch (Exception e) {
    // 其他异常
    return Result.fail(500, "系统异常");
}