Spring WebFlux应用CORS配置失效问题求助

问题诊断 #

你的配置同时使用了allowedOrigins("*")和allowedOriginPatterns("*")，这两个方法存在逻辑冲突。WebFlux中allowedOriginPatterns是替代allowedOrigins的新特性，用于支持更灵活的来源匹配规则，同时启用两者会导致CORS配置逻辑混乱，这大概率是配置不生效的核心原因。另外，"Failed to fetch"错误也可能和请求是否携带凭证（如Cookie）有关。

修正后的配置方案 #

方案1：使用allowedOriginPatterns（推荐，支持复杂来源匹配） #

@Configuration 
@EnableWebFlux 
class CorsConfig : WebFluxConfigurer {
    override fun addCorsMappings(corsRegistry: CorsRegistry) {
        corsRegistry.addMapping("/**")
            .allowedOriginPatterns("*")
            .allowedMethods("*")
            .allowedHeaders("*")
            .allowCredentials(true) // 若请求需要携带Cookie等凭证，必须开启此项
            .maxAge(3600) // 预检请求缓存时长，减少重复预检请求
    }
}

方案2：仅使用allowedOrigins（适用于简单场景） #

注意：使用allowedOrigins("*")时不能开启allowCredentials(true)，这是CORS规范强制要求，否则浏览器会直接拒绝响应。

@Configuration 
@EnableWebFlux 
class CorsConfig : WebFluxConfigurer {
    override fun addCorsMappings(corsRegistry: CorsRegistry) {
        corsRegistry.addMapping("/**")
            .allowedOrigins("*")
            .allowedMethods("*")
            .allowedHeaders("*")
            .maxAge(3600)
    }
}

额外排查方向 #

• 验证请求协议：确保前端请求的URL使用http或https协议，避免file://等本地协议触发CORS限制。
• 排除网络问题：用Postman等工具直接请求后端接口，确认接口本身能正常响应，排除网络链路故障。
• 检查过滤器优先级：如果项目中有自定义过滤器，需确保CORS相关过滤器优先级最高，避免其他过滤器先拦截请求导致CORS响应头未被正确添加。

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