如何在标注自定义注解的方法缺少指定参数时抛出错误/警告

1. 运行时切面内即时检查 #

在你的@Before切面方法中，通过JoinPoint获取目标方法的参数类型，遍历判断是否包含HttpServletRequest。如果不存在，直接输出警告日志，也可以根据业务需求抛出异常强制拦截。

示例代码：

@Aspect
@Component
public class LogAspect {

    private static final Logger logger = LoggerFactory.getLogger(LogAspect.class);

    @Before("@annotation(com.yourpackage.LogAnnotation)")
    public void beforeLogMethod(JoinPoint joinPoint) {
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Class<?>[] paramTypes = signature.getMethod().getParameterTypes();
        
        boolean hasServletRequest = false;
        for (Class<?> type : paramTypes) {
            if (HttpServletRequest.class.isAssignableFrom(type)) {
                hasServletRequest = true;
                break;
            }
        }

        if (!hasServletRequest) {
            logger.warn("Method {} annotated with @LogAnnotation lacks HttpServletRequest parameter, full logging won't be possible", 
                        signature.toShortString());
            // 若需强制校验，可抛出异常
            // throw new IllegalArgumentException("Methods annotated with @LogAnnotation must include HttpServletRequest parameter");
        }

        // 原有日志记录逻辑...
    }
}

2. 启动时批量校验（提前发现问题） #

如果希望在应用启动阶段就排查所有不符合要求的方法，避免运行时才暴露问题，可以用BeanPostProcessor扫描所有控制器Bean，反射检查标注了自定义注解的方法：

@Component
public class LogAnnotationValidator implements BeanPostProcessor {

    private static final Logger logger = LoggerFactory.getLogger(LogAnnotationValidator.class);

    @Override
    public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
        // 仅处理控制器类，可根据实际范围调整
        if (bean.getClass().isAnnotationPresent(Controller.class) || 
            bean.getClass().isAnnotationPresent(RestController.class)) {
            
            for (Method method : bean.getClass().getDeclaredMethods()) {
                if (method.isAnnotationPresent(LogAnnotation.class)) {
                    Class<?>[] paramTypes = method.getParameterTypes();
                    boolean hasServletRequest = false;
                    for (Class<?> type : paramTypes) {
                        if (HttpServletRequest.class.isAssignableFrom(type)) {
                            hasServletRequest = true;
                            break;
                        }
                    }
                    if (!hasServletRequest) {
                        logger.warn("Controller {}'s method {} is annotated with @LogAnnotation but missing HttpServletRequest parameter",
                                    bean.getClass().getSimpleName(), method.getName());
                    }
                }
            }
        }
        return bean;
    }
}

3. 编译时校验（严格规范场景） #

如果需要在编译阶段就强制检查（避免不符合规范的代码上线），可以实现Java注解处理器。这种方式会在编译时扫描所有标注@LogAnnotation的方法，若缺少指定参数则抛出编译警告或错误，不过实现复杂度较高，适合对代码规范要求严格的场景。

选型建议 #

• 运行时检查适合需要在方法调用时即时告警的场景
• 启动时校验能提前排查所有问题，避免运行时才暴露
• 通常建议组合使用：启动时校验做提前排查，运行时检查做兜底，确保覆盖所有情况

内容的提问来源于stack exchange，提问作者martin