当前位置：首页 > news >正文

Spring Cloud Gateway的快速使用

news 2025/8/6 3:30:56

环境前置搭建Nacos：点击跳转

Spring Cloud Gateway Docs

新建gateway网关模块

在这里插入图片描述

`pom.xml`导入依赖

<!-- 网关 -->
<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<!-- nacos服务发现依赖 -->
<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

编写启动类`GatewayApplication.java`（不是新模块就不用编写）

@SpringBootApplication
public class GatewayApplication {public static void main(String[] args) {SpringApplication.run(GatewayApplication.class, args);}
}

`application.yml`配置gateway

server:port: 10010 # 网关端口
spring:application:name: gateway # 服务名称cloud:nacos:server-addr: localhost:8848 # nacos地址gateway:routes: # 网关路由配置- id: user-service # 路由id，自定义，只要唯一即可# uri: http://127.0.0.1:8081 # 路由的目标地址 http就是固定地址uri: lb://userservice # 路由的目标地址 lb就是负载均衡，后面跟服务名称predicates: # 路由断言，也就是判断请求是否符合路由规则的条件- Path=/user/** # 这个是按照路径匹配，只要以/user/开头就符合要求- id: order-serviceuri: lb://orderservicepredicates:- Path=/order/**

完成以上配置，直接启动即可，访问 http://localhost:10010

`GatewayFilter Factories` 过滤器工厂：GatewayFilter Factories文档

`application.yml` 中filters属性

spring:cloud:gateway:routes: # 网关路由配置- id: user-service # 路由id，自定义，只要唯一即可uri: lb://userservice # 路由的目标地址 lb就是负载均衡，后面跟服务名称predicates: # 路由断言，也就是判断请求是否符合路由规则的条件- Path=/user/** # 这个是按照路径匹配，只要以/user/开头就符合要求filters: # 过滤器给请求头添加信息- AddRequestHeader=info, header add new info # 格式：key, value  => ['info']="header add new info"- id: order-serviceuri: lb://orderservicepredicates:- Path=/order/**filters:- AddRequestHeader=info, header add new info  # ['info']="header add new info"default-filters: # 默认过滤项- AddRequestHeader=DefaultInfo, all service add new info # ['DefaultInfo']="all service add new info."

`全局过滤器`：由于配置无法处理业务，可以使用代码实现过滤器

新建`AuthorizeFilter.java`实现`GlobalFilter 接口`重写 filter方法

@Order(-1)  // 过滤器执行链的顺序
@Component
public class AuthorizeFilter implements GlobalFilter {@Overridepublic Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {// 获取请求参数MultiValueMap<String, String> params = exchange.getRequest().getQueryParams();// 获取authorization参数String auth = params.getFirst("authorization");// 校验if ("admin".equals(auth)) {// 放行return chain.filter(exchange);}// 设置状态码exchange.getResponse().setStatusCode(HttpStatus.FORBIDDEN);// 结束处理, 没有通过直接返回return exchange.getResponse().setComplete();}
}

执行顺序大致为：client → 路由 → 默认过滤器 → 局部(路由)过滤器 → 全局过滤器
在这里插入图片描述

解决跨域问题

跨域问题：浏览器禁止请求的发起者与服务端发生跨域ajax请求，请求被浏览器拦截的问题。
跨域问题并不是提供者和消费者的问题，而是浏览器禁止跨域导致的。

`application.yml`

spring:cloud:gateway:# ...globalcors: # 全局的跨域处理add-to-simple-url-handler-mapping: true  # 解决options请求被拦截问题corsConfigurations:'[/**]':allowedOrigins: # 允许哪些网站的跨域请求 - "http://localhost:5500"- "http://127.0.0.1:5500"allowedMethods: # 允许的跨域ajax的请求方式- "GET"- "POST"- "DELETE"- "PUT"- "OPTIONS"allowedHeaders: "*" # 允许在请求中携带的头信息allowCredentials: true # 是否允许携带cookiemaxAge: 360000 # 这次跨域检测的有效期，避免每次检查损耗效率