Spring cloud gateway 跨域配置与碰到的问题

使用Spring cloud gateway 创建的一个网关服务后,在application.yml中配置跨域,如下:

复制代码
spring:
  cloud:
    gateway:
      routes:
        - id: xxxxx
          uri: https://www.xxxxx.com
          predicates:
            - Path=/xxx/**
          filters:
            - StripPrefix=1
      globalcors:
        # 解决OPTIONS请求被拦截问题
        add-to-simple-url-handler-mapping: true
        cors-configurations:
          '[/**]':
            # 允许跨域的请求源(Spring Boot 2.4+版本使用此配置)
            allowedOriginPatterns: ["*"]
            allowedMethods: ["*"]
            allowedHeaders: ["*"]
            # 是否允许携带cookie
            allowCredentials: true
            # 跨域检测的有效期,单位秒
            maxAge: 3600

注意事项:

  • 凭证与通配符限制 ‌:当allow-credentials设置为true时,allowed-origins 不能设置为 "*",必须指定具体域名
  • options请求处理 ‌:必须配置add-to-simple-url-handler-mapping: true来确保预检请求不被拦截
  • 版本兼容性 ‌:Spring Boot 2.4及以上版本推荐使用allowed-origin-patterns替代allowed-origins

Spring Cloud Gateway配置跨域后确实会在响应头中添加跨域相关配置。

在一些微服务场景下,比如调用第三方服务的时候,第三方服务有可能也配置了跨域配置,如果这时,我们网关服务也配置了跨域配置,就会在响应头中出现多个Access-Control-Allow-Origin 响应头,从而导致跨域配置失效。

为避免出现多个Access-Control-Allow-Origin响应头,需要使用DedupeResponseHeader 过滤器来去重响应头

DedupeResponseHeader过滤器‌的作用:

  • 用于去除重复的响应头
  • 可指定多个需要去重的响应头名称,用空格分隔
  • 支持多种去重策略,如RETAIN_FIRST(保留第一个)、RETAIN_LAST(保留最后一个)等

完整的配置如下:

复制代码
spring:
  cloud:
    gateway:
      routes:
        - id: xxxxx
          uri: https://www.xxxxx.com
          predicates:
            - Path=/xxx/**
          filters:
            - StripPrefix=1
      globalcors:
        # 解决OPTIONS请求被拦截问题
        add-to-simple-url-handler-mapping: true
        cors-configurations:
          '[/**]':
            # 允许跨域的请求源(Spring Boot 2.4+版本使用此配置)
            allowedOriginPatterns: ["*"]
            allowedMethods: ["*"]
            allowedHeaders: ["*"]
            # 是否允许携带cookie
            allowCredentials: true
            # 跨域检测的有效期,单位秒
            maxAge: 3600
      default-filters:
        # 使用RETAIN_FIRST策略确保保留最先设置的响应头值,也就是网关的跨域配置
        - DedupeResponseHeader=Vary Access-Control-Allow-Origin Access-Control-Allow-Credentials, RETAIN_FIRST
相关推荐
zhz5214几秒前
Spring Boot 接入国密实战:传输加密(TLCP)+ 密码加密(SM4)
java·spring boot·后端·国密·sm4
人道领域4 分钟前
【LeetCode刷题日记】617.合并二叉树(空间换安全,还是原地省内存)
java·数据结构·算法·leetcode
独自破碎E8 分钟前
机器人Java后端算法笔试题解析
java·windows·算法
我是一颗柠檬8 分钟前
【JDK8新特性】函数式接口Day2
java·开发语言·后端·intellij-idea
Bat U9 分钟前
JavaEE|JVM
java·jvm·java-ee
Mahir0811 分钟前
Spring Boot 自动装配深度解密:从原理到自定义 Starter 实战
java·spring boot·后端·自动装配·自定义starter·大厂面试题
淘源码d12 分钟前
产科系统源码,数字产科源码,Java(后端) + Vue + ElementUI(前端) + MySQL(数据库),确保系统稳定性与扩展性。
java·源码·数字产科·产科系统·智能化孕产服务·高危五色预警·智慧产科
wand codemonkey1 小时前
SpringbootWeb【入门】+MySQL【安装】+【DataDrip安装 】+【连接MySQL】
java·mysql·mybatis
Mahir089 小时前
Spring 循环依赖深度解密:从问题本质到三级缓存源码级解析
java·后端·spring·缓存·面试·循环依赖·三级缓存
RyFit10 小时前
SpringAI 常见问题及解决方案大全
java·ai