Spring AOP实战：如何高效获取请求参数并避免常见陷阱

1次阅读

没有评论

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

在日常 Web 开发中，我们经常需要获取 HTTP 请求参数进行日志记录、权限校验、参数校验等操作。传统方式通常有以下几种：

在每个 Controller 方法中手动获取 HttpServletRequest 对象
使用 Spring 的 @RequestParam 或 @RequestBody 注解逐个获取参数
通过拦截器 (Interceptor) 获取参数

这些方式存在明显的缺点：

代码重复：相同的参数获取逻辑需要在多个地方重复编写
侵入性强：业务代码中混杂了大量非业务逻辑
性能损耗：频繁的请求参数解析影响接口响应速度

Spring AOP 提供了一种优雅的解决方案：

非侵入性：业务代码完全不需要关心参数获取逻辑
集中管理：所有参数处理逻辑统一在一个地方
灵活组合：可以自由组合各种 Advice(通知)类型
性能优化：避免重复解析请求参数

在 AOP 中，JoinPoint 对象封装了目标方法的所有信息。获取请求参数主要通过以下步骤：

通过 JoinPoint 获取方法签名(MethodSignature)
从方法签名中获取目标方法(Method)
获取方法的参数名称和参数值

关键注意事项：

默认情况下 Java 字节码不保留参数名，需要通过编译参数 -parameters 或使用注解 @ParamName
对于接口代理 (JDK 动态代理) 和类代理 (CGLIB) 获取参数的方式略有不同
获取参数值时需要考虑参数是否为基本类型及其包装类

@Aspect
@Component
public class RequestParamAspect {private static final Logger logger = LoggerFactory.getLogger(RequestParamAspect.class);

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

    /**
     * 前置通知：获取请求参数
     */
    @Before("controllerPointcut()")
    public void beforeAdvice(JoinPoint joinPoint) {
        try {MethodSignature signature = (MethodSignature) joinPoint.getSignature();
            Method method = signature.getMethod();
            String[] paramNames = signature.getParameterNames();
            Object[] paramValues = joinPoint.getArgs();

            // 打印方法信息
            logger.info("拦截方法: {}.{}", method.getDeclaringClass().getName(), method.getName());

            // 打印参数信息
            if (paramNames != null && paramNames.length > 0) {StringBuilder paramInfo = new StringBuilder("请求参数:");
                for (int i = 0; i < paramNames.length; i++) {paramInfo.append(paramNames[i]).append("=").append(paramValues[i]).append(";");
                }
                logger.info(paramInfo.toString());
            }

            // 特殊处理 MultipartFile 参数
            for (Object arg : joinPoint.getArgs()) {if (arg instanceof MultipartFile) {MultipartFile file = (MultipartFile) arg;
                    logger.info("上传文件: {} ({} bytes)", file.getOriginalFilename(), file.getSize());
                }
            }
        } catch (Exception e) {logger.error("获取请求参数异常", e);
        }
    }
}

处理最简单，直接通过 JoinPoint.getArgs()获取即可。需要注意的是基本类型和其包装类的自动装箱 / 拆箱问题。

当参数是 POJO 对象时，Spring MVC 会通过 HttpMessageConverter 自动转换。在 AOP 中获取的是已经转换好的对象。

文件上传参数需要特殊处理：