Spring Boot拦截器排除指定路径失败，多方案尝试均无效

你遇到的核心问题是混淆了请求路径和子域名的概念，同时对Spring Interceptor的excludePathPatterns作用范围理解有误。以下是具体分析和解决方案：

一、为什么你的排除规则无效？ #

1. excludePathPatterns只过滤请求路径，不处理域名
   你写的"/localhost/**"规则完全无效，因为localhost是请求的域名，而非URL中域名后的路径部分。Spring的路径匹配仅针对request.getServletPath()返回的内容（即域名、端口之后的路径，比如http://localhost:8080/clientcontrol/list的路径是/clientcontrol/list）。

2. 若你的真实需求是排除特定子域名，excludePathPatterns完全不适用
   你的Interceptor核心逻辑是检查子域名，如果你想让clientcontrol或localhost这类子域名的请求跳过验证，靠路径排除规则根本达不到目的——因为子域名是域名的一部分，和请求路径无关。

二、针对两种需求的解决方案 #

需求1：排除特定路径（不管域名，只要路径匹配就放行） #

如果确实是要让符合/clientcontrol/**这类路径的请求跳过拦截，确保以下几点：

• 路径规则和实际请求路径匹配（比如请求路径是/clientcontrol/xxx，规则/clientcontrol/**是匹配的）
• 正确配置拦截器，确保Spring能识别排除规则

修改后的代码示例：

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Autowired
    JdbcTemplate jdbcTemplate;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new HandlerInterceptor() {
            @Override
            public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
                    throws Exception {
                String subdomain = extractSubdomain(request);
                verifySubdomain(subdomain);
                return true;
            }
        })
        // 仅排除指定路径，AntPathMatcher是默认实现，可省略
        .excludePathPatterns("/clientcontrol/**");
    }

    // 你的子域名提取和验证方法
    private String extractSubdomain(HttpServletRequest request) {
        // 实现逻辑
    }

    private void verifySubdomain(String subdomain) throws Exception {
        // 验证逻辑，不通过则抛异常
    }
}

如果这样配置后仍生效，检查：

• 请求路径是否真的匹配/clientcontrol/**（比如是否带前缀/api等，若有则规则要改成/api/clientcontrol/**）
• 是否有其他拦截器或配置覆盖了当前规则

需求2：排除特定子域名（跳过子域名验证） #

这应该是你真正的需求——让clientcontrol或localhost子域名的请求不执行子域名验证。此时不需要excludePathPatterns，直接在拦截器逻辑中判断子域名即可：

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Autowired
    JdbcTemplate jdbcTemplate;

    // 定义要排除的子域名列表
    private static final Set<String> EXCLUDED_SUBDOMAINS = new HashSet<>(Arrays.asList("clientcontrol", "localhost"));

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new HandlerInterceptor() {
            @Override
            public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
                    throws Exception {
                String subdomain = extractSubdomain(request);
                
                // 若子域名在排除列表中，直接放行
                if (EXCLUDED_SUBDOMAINS.contains(subdomain)) {
                    return true;
                }
                
                // 非排除子域名才执行验证
                verifySubdomain(subdomain);
                return true;
            }
        });
    }

    private String extractSubdomain(HttpServletRequest request) {
        String serverName = request.getServerName();
        // 示例：从域名中提取子域名，比如"clientcontrol.example.com"提取"clientcontrol"
        int dotIndex = serverName.indexOf('.');
        if (dotIndex == -1) {
            return serverName; // 无域名后缀，比如localhost
        }
        return serverName.substring(0, dotIndex);
    }

    private void verifySubdomain(String subdomain) throws Exception {
        // 你的验证逻辑，比如从数据库查询子域名是否合法
        String sql = "SELECT COUNT(*) FROM valid_subdomains WHERE name = ?";
        Integer count = jdbcTemplate.queryForObject(sql, Integer.class, subdomain);
        if (count == null || count == 0) {
            throw new Exception("Invalid subdomain");
        }
    }
}

三、额外注意事项 #

• 若你的extractSubdomain方法逻辑有问题（比如无法正确提取子域名），会导致排除规则失效，需先确保该方法能正确获取到子域名。
• 避免将域名和路径混淆，明确自己的需求是排除路径还是排除域名，再选择对应的实现方式。

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