Java跨域CorsFilter不生效原因与解决方案

Java跨域配置CorsFilter不生效的原因与解决方案

在使用Spring Boot开发接口时，跨域配置是一个无法回避的常见问题。但有时即使按照常规方式配置了CorsFilter，前端依然会报跨域错误。尤其是当项目中存在多个过滤器（Filter）时，这一问题更容易出现，往往让人无从下手。

问题根源：多个Filter的执行顺序导致拦截

当项目中有多个Filter时，这些过滤器的执行顺序并非随机。如果CorsFilter没有在其他过滤器之前执行，跨域相关的请求头可能会被后续的过滤器“拦截”或修改，从而导致前端收到跨域错误提示。

解决的关键在于显式设置CorsFilter的优先级。通过 @Order(Ordered.HIGHEST_PRECEDENCE) 注解，可以强制让CorsFilter在最早阶段执行，从而避免被其他过滤器干扰：

@Order的优先级规则说明

关于 @Order 注解的执行规则，以下几点值得特别关注：

• 1. 数值越小，优先级越高。 Ordered.HIGHEST_PRECEDENCE 表示最高优先级，其实际数值为 Integer.MIN_VALUE，可确保在所有过滤器之前执行。
• 2. 默认行为。如果不标注任何数值，默认优先级为最低，等同于 Ordered.LOWEST_PRECEDENCE，其默认值为 Integer.MAX_VALUE。
• 3. @Order 等同于实现 Ordered 接口。通过实现 Ordered 接口的 getOrder() 方法并返回对应数值，同样可以达到控制执行顺序的效果。

CorsConfig 并未直接实现 Filter 接口

这是一个容易踩坑的地方：直接在一个配置类中用 @Bean 返回 CorsFilter，往往无法生效。因为 @Order 注解虽然可以标注在 @Bean 方法上，但它控制的是 Bean 自身的执行顺序，而非 Filter 链的执行顺序。

更稳妥的做法是通过 FilterRegistrationBean 来注册过滤器，并显式设置 order 值，确保其在过滤器链中优先执行：

import com.nanase.takeshi.constants.JwtConstant;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.Ordered;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;

/**
 * CorsConfig
 * 跨域请求配置
 *
 * @author 725
 * @date 2020/12/10 18:17
 */
@Slf4j
@Configuration
public class CorsConfig {

    private CorsConfiguration buildConfig() {
        CorsConfiguration corsConfiguration = new CorsConfiguration();
        // 1 设置访问源地址
        corsConfiguration.addAllowedOrigin("*");
        // 2 设置访问源请求头
        corsConfiguration.addAllowedHeader("*");
        // 3 设置访问源请求方法
        corsConfiguration.addAllowedMethod("*");
        // 4 暴露哪些头部信息
        corsConfiguration.addExposedHeader(JwtConstant.HEADER);
        return corsConfiguration;
    }

    @Bean
    public FilterRegistrationBean corsFilter() {
        log.info("跨域设置。。。。");
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        // 5 对接口配置跨域设置
        source.registerCorsConfiguration("/**", buildConfig());
        // 有多个filter时此处设置改CorsFilter的优先执行顺序
        FilterRegistrationBean bean = new FilterRegistrationBean<>(new CorsFilter(source));
        bean.setOrder(Ordered.HIGHEST_PRECEDENCE);
        return bean;
    }

}

总结

跨域配置看似简单，实则隐藏着不少细节。核心要点只有一个：确保CorsFilter在过滤器链中以最高优先级执行。如果直接返回 CorsFilter Bean 不生效，改用 FilterRegistrationBean 并显式设置 order 值，是更可靠且通用的解决方案。