Jakarta EE拦截器仅类上生效，继承方法添加不触发问题排查

在Jakarta EE（原Java EE）生态中，当你在重写接口的方法上直接使用@Interceptors注解时，容器通常不会触发拦截器——这是因为Java的注解继承规则限制：方法级别的注解默认不会被继承，即使你在实现类的重写方法上手动添加注解，容器也不会将其识别为有效的拦截器绑定点。而类级别的@Interceptors会作用于类的所有方法，所以能正常生效，但这显然不符合你只想拦截特定方法的需求。

通过自定义CDI拦截器绑定注解，并将其标注在父接口的目标方法上，就能让实现类的重写方法自动触发拦截器。同时我们可以在拦截器中集成Bean Validation，完成输入参数的校验逻辑。

步骤1：定义拦截器绑定注解 #

创建一个带有@InterceptorBinding的自定义注解，用于标记需要拦截的方法：

import jakarta.interceptor.InterceptorBinding;
import java.lang.annotation.*;

@InterceptorBinding
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidateSpecification {
}

步骤2：改造拦截器类 #

将自定义绑定注解添加到拦截器类上，并实现Bean Validation的参数校验逻辑：

import jakarta.interceptor.AroundInvoke;
import jakarta.interceptor.Interceptor;
import jakarta.interceptor.InvocationContext;
import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import jakarta.validation.Validation;
import jakarta.validation.Validator;
import java.util.Set;

@Interceptor
@ValidateSpecification
public class SpecificationValidator {

    private final Validator validator = Validation.buildDefaultValidatorFactory().getValidator();

    @AroundInvoke
    public Object aroundInvoke(InvocationContext ctx) throws Exception {
        System.out.println("Intercepted method: " + ctx.getMethod().getName());
        
        // 对输入参数执行Bean Validation校验
        Object[] parameters = ctx.getParameters();
        if (parameters != null && parameters.length > 0) {
            for (Object param : parameters) {
                Set<ConstraintViolation<Object>> violations = validator.validate(param);
                if (!violations.isEmpty()) {
                    throw new ConstraintViolationException("参数校验失败", violations);
                }
            }
        }
        
        return ctx.proceed();
    }
}

步骤3：在父接口的目标方法上标注绑定注解 #

将@ValidateSpecification添加到ManagementService的create方法上，这样所有实现该接口的类的create方法都会被自动拦截：

public interface ManagementService<D,S> {
    @ValidateSpecification
    D create(S specification) throws AlreadyExistsException;
}

步骤4：简化实现类代码 #

现在实现类不需要再添加任何拦截器相关注解，只需正常重写方法即可：

import jakarta.ejb.Stateless;

@Stateless
public class UserManagementServiceImpl implements UserManagementService {
    @Override
    public User create(UserSpec spec) {
        // 业务逻辑实现
    }
}

CDI的拦截器绑定机制会识别接口方法上的绑定注解，并将其自动应用到实现类的对应方法上，绕过了Java方法注解不继承的限制。这样你就能精准地只拦截create这类特定方法，同时完成参数的Bean Validation校验。

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