SpringCloud Gateway网关 项目创建 及 整合Nacos开发

时间:2025-04-11 13:57:31

创建springBoot 网关子项目

1 添加maven依赖,注意不加添加  spring-boot-starter-web

<!--添加gateway网关-->
<dependency>
       <groupId></groupId>
       <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

<!-- nacos注册中心 -->
<dependency>
      <groupId></groupId>
      <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

<!-- nacos配置中心 -->
<dependency>
      <groupId></groupId>
      <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

<!-- 用于在应用启动时加载外部配置注册中心,配置中心  -->
<dependency>
    <groupId></groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

2 编辑文件,并检查保证 每个属性可以点击打开

server:
  port: 8888

spring:
  application:
    name: huawei-api-gateway
  cloud:
    nacos:
      discovery:
        server-addr: http://47.111.185.251:8848
    gateway:
      discovery:
        locator:
          enabled: true  #开启网关拉取nacos的服务
      routes: #数组形式
        - id: order-service  #路由唯一标识
          uri: lb://huawei-order-service  #想要转发到的地址,从nacos获取名称转发,lb是负载均衡轮训策略
          order: 1 #优先级,数字越小优先级越高
          predicates: #断言 配置哪个路径才转发
            - Path=/order-server/**
          filters: #过滤器,请求在传递过程中通过过滤器修改
            - StripPrefix=1  #去掉第一层前缀
        - id: video-service
          uri: lb://huawei-video-service
          order: 1
          predicates:
            - Path=/video-server/**
          filters:
            - StripPrefix=1

3 编写启动类

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {
    public static void main(String[] args) {
        (,args);
        ("网关--服务启动");
    }
}

4 检查Nacos控制台是否已经成功注册服务

5 开始测试
原来访问的方式 http://localhost:8001/order/fangfa_5?videoId=46 

现在通过网关访问的方式 http://localhost:8888/order-server/order/fangfa_5?videoId=46

通过网关访问某接口的方法
http://网关服务的ip:网关服务的端口  /路由映射中服务名对应的url规则(predicates)  /control层的UrlMapping



常见错误解决办法


1 网关访问时出现如下错误
        : 503 SERVICE_UNAVAILABLE "Unable to find instance for user-service" 
        为什么会这样,是因为在Spring Cloud 2020版本以后,默认移除了对Netflix的依赖,其中就包括Ribbon,官方默认推荐使用Spring Cloud Loadbalancer正式替换Ribbon,并成为了Spring Cloud负载均衡器的唯一实现


解决办法:网关项目中添加以下依赖

<dependency>
       <groupId></groupId>
	   <artifactId>spring-cloud-loadbalancer</artifactId>
</dependency>