使用@AutoConfigureAfter(WebMvcAutoConfiguration.class)时拦截器无法调用问题

这问题我之前也碰到过，核心原因是你用错了@AutoConfigureAfter的适用场景，咱们一步步来拆解和解决：

问题根源 #

@AutoConfigureAfter注解是专门为Spring Boot自动配置类（也就是那些在META-INF/spring.factories中声明的@Configuration类）设计的，用来控制自动配置的加载顺序。而你的Application类是项目的主启动类，本身是Spring容器的核心配置类，默认加载优先级极高。

当你给主启动类加上@AutoConfigureAfter(WebMvcAutoConfiguration.class)时，会强制让它在WebMvcAutoConfiguration之后加载。而WebMvcAutoConfiguration负责初始化Spring MVC的核心机制，包括拦截器链的构建。等你的Application类（以及它@Import的CommonConfig）执行拦截器注册逻辑时，MVC的拦截器链已经定型了，你的拦截器根本没机会被加入进去，自然不会被调用。

解决方案 #

方案1：直接移除主类上的@AutoConfigureAfter #

如果没有特殊的强制配置顺序需求，最简单的解决方法就是把Application类上的@AutoConfigureAfter(WebMvcAutoConfiguration.class)删掉。主启动类不需要这个注解，它的默认加载顺序完全能保证你的拦截器配置被正常识别：

@Import(CommonConfig.class)
@EnableAsync
@SpringBootApplication
@EnableSwagger2
@EnableScheduling
@EnableSpringDataWebSupport
@ImportResource({ "classpath:META-INF/applicationContext.xml" })
public class Application extends SpringBootServletInitializer {
    private static final Logger LOG = LoggerFactory.getLogger(Application.class);
    
    // 其他业务代码...
}

方案2：将拦截器配置移到专门的配置类（如果必须调整顺序） #

如果你确实需要让拦截器相关配置在WebMvcAutoConfiguration之后执行，应该把拦截器注册逻辑放到独立的@Configuration类中，再给这个类加上@AutoConfigureAfter，而不是加到主启动类上：

1. 创建专门的Web配置类：

@Configuration
@AutoConfigureAfter(WebMvcAutoConfiguration.class)
public class WebMvcInterceptorConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注册你的自定义拦截器，示例如下
        registry.addInterceptor(new YourCustomInterceptor())
                .addPathPatterns("/**") // 拦截所有路径
                .excludePathPatterns("/login", "/register"); // 排除不需要拦截的路径
    }
}

2. 确保主启动类移除掉@AutoConfigureAfter注解，保持原有核心配置即可。

额外检查点 #

• 确认你的CommonConfig中如果包含WebMvcConfigurer的实现，不要给它加错误的顺序注解，避免同样的问题。
• 验证拦截器类本身是否正确实现了HandlerInterceptor接口，重写了preHandle/postHandle等方法。

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