论坛 › Oracle › 从零搭建微服务项目（第7章——微服务网关模块底子实现）

熊熊出没 发表于 2025-2-17 06:47:02

从零搭建微服务项目（第7章——微服务网关模块底子实现）

媒介：

在前面6章的学习中已经完成了服务间的调用实现，即各微服务通过nacos或eureka服务器完成服务的注册，并从nacos中拉取配置实现热更新。当某个服务接口需要调用其他服务时，通过feign定义接口，并通过注解配置服务名称，在nacos或eureka服务器中找到对应服务端口完成调用。
但实际应用中，用户不可能直接访问这些服务端口，由于每个服务对应一个端口，当服务拆分很多时，会有大量端口，前端开辟人员不可能针对每次调用看文档找对应端口，因此引入网关模块，用户只需要访问网关模块端口，网关模块自动转发，且网关模块也能实现服务聚合、负载均衡、用户鉴权等功能。为此，本章实现底子的网关模块，包括网关服务模块创建、路由断言、过滤器配置。
https://i-blog.csdnimg.cn/direct/d9ee89fc2a104f0c8af40e830d2e4663.png
本章代码基于第6章项目，前置源码可在第6章博客下载，博客链接如下：
从零搭建微服务项目（第6章——Feign性能优化以及模块抽取）-CSDN博客https://csdnimg.cn/release/blog_editor_html/release2.3.8/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=P1C7https://blog.csdn.net/wlf2030/article/details/145649565扼要介绍前置项目流程：order-service以及user-service两服务分别连接order-db以及user-db两数据库，order-db中仅有user-id，user-info存在user-db中，为提供完备order-info，order-service通过nacos发现user-service服务地址并使用Feign调用服务端口拿取user-info联合从order-db中拿取的信息返回给前端。同时项目自定义日记输出。
本项目源码链接如下:
wlf728050719/SpringCloudBase7https://csdnimg.cn/release/blog_editor_html/release2.3.8/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=P1C7https://github.com/wlf728050719/SpringCloudBase7以及本专栏会连续更新微服务项目，每一章的项目都会基于前一章项目举行功能的完善，欢迎小同伴们关注！同时假如只是对单章感兴趣也不消从头看，只需下载前一章项目即可，每一章都会有前置项目准备部门，跟着操作就能实现上一章的最终结果，当然假如是一直跟着做可以直接跳过这一部门。
https://i-blog.csdnimg.cn/direct/323f489e0431417db7aa5be0c6430cdd.png
一、前置项目准备

1.从github下载前一章的项目解压，重命名为Base7打开。
https://i-blog.csdnimg.cn/direct/cfb58d119f0a4a4abccb1ed756929841.png
2.重命名模块为Base7.
https://i-blog.csdnimg.cn/direct/e3a7d2fd185a4e9694330bcb91b48c72.png
3.父工程pom.xml中<name>改成Base7。
https://i-blog.csdnimg.cn/direct/5fed651c0a0c434084614e05cdbc65f7.png
4.选择环境为dev,并重新加载maven
https://i-blog.csdnimg.cn/direct/355fcb536da24ef19a6861b2d02e936c.png
5.启动nacos（安装和启动见第三章）
https://i-blog.csdnimg.cn/direct/94f212563c7c446eb9c809a94b5ffa26.png
6.进入nacos网页 配置管理->配置列表确认有这些yaml文件。
（假如不是一直跟着专栏做自然是没有的，需要看第四章的环境隔离和配置拉取，记得把父工程pom文件中namespace的值与nacos中命名空间生成的保持同等）
https://i-blog.csdnimg.cn/direct/fad42b8283c745208f06881289d20872.png
https://i-blog.csdnimg.cn/direct/feff8327d0924f35a0952458bfdf51d0.png
7.配置数据源，更换两服务的resources下yml文件的数据库配置,数据库sql见第一章数据库准备部门。
https://i-blog.csdnimg.cn/direct/c7d632b5ed86458e8ef476131cb6338a.png
.测试数据库连接 属性->点击数据源->测试连接->输入用户名密码
https://i-blog.csdnimg.cn/direct/461d7c53da6c468daf40a7c95805ef15.png
https://i-blog.csdnimg.cn/direct/c92431b2e0994c1c8539f1a95177eee1.png
https://i-blog.csdnimg.cn/direct/421a4b77ec9d452289f741ae4b6f1420.png
8.添加运行配置 服务->加号->运行配置范例->spring boot。
https://i-blog.csdnimg.cn/direct/ef0db64783474bc79e1776730f083e5a.png
启动服务，测试接口。
https://i-blog.csdnimg.cn/direct/2000e47e519747408c238aca665bed1a.png
能够在日记文件中看到最新的日记记录。
https://i-blog.csdnimg.cn/direct/88653e5c9a9042d4b9085cbd7d61af3e.png
https://i-blog.csdnimg.cn/direct/13b87ec1398c4370aae2f511d13a0c78.png
二、网关服务模块创建以及配置

1.新建SpringBoot模块，配置如下。
https://i-blog.csdnimg.cn/direct/e545f777a5b8495f9eacf5336a7136d1.png
2.不添加任何依赖
https://i-blog.csdnimg.cn/direct/fd750eaf27554911a6804dd3c8d2bec9.png
3.删除不须要文件和目录，最终结构如下。
https://i-blog.csdnimg.cn/direct/3dacf3581279424a8ee823e9faf45738.png
4.将gateway模块的pom文件替换为下面内容。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
      <groupId>cn.bit</groupId>
      <artifactId>Base7</artifactId>
      <version>1.0-SNAPSHOT</version>
      <relativePath>../pom.xml</relativePath>
    </parent>

    <artifactId>gateway</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>gateway</name>
    <description>gateway</description>

    <dependencies>
      <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
            <version>2.2.5.RELEASE</version>
      </dependency>
      <!-- nacos客户端依赖包 -->
      <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
      </dependency>
    </dependencies>

    <build>
      <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
      </plugins>
    </build>

</project>
4.修改父文件pom，即将gateway模块声明为父模块的子模块，重新加载maven模块。
https://i-blog.csdnimg.cn/direct/035d3d4e88c24791ab6b78261c9b3926.png
5.重新加载maven文件后，检察maven结构是否如下，假如不是见本专栏第0章第三节部门有对应解决方法。
https://i-blog.csdnimg.cn/direct/2a315f6806eb45d3b2e1671010ff8f90.png
6.在父文件pom中为gateway在各配置环境下设置端口。
https://i-blog.csdnimg.cn/direct/6be23f3b10324fb3bef8732531203037.png
7.在gateway的application中排除默认数据源，否则需要在application中配置数据源，后续动态路由时需要使用数据库时再规复。
https://i-blog.csdnimg.cn/direct/d8aa492029954845b19642956efa488b.png
8.为gateway在resources目录下创建application.yml配置文件，内容如下:
server:
port: @gateway.port@
spring:
application:
    name: gateway
cloud:
    nacos:
      server-addr: localhost:8848
      discovery:
      namespace: @namespace@
    gateway:
      routes:
      - id: user-service
          uri:
            lb://user-service
          predicates:
            - Path=/user/**
      - id: order-service
          uri:
            lb://order-service
          predicates:
            - Path=/order/**
9.启动服务
https://i-blog.csdnimg.cn/direct/a35b52b396724816ac51b9089b824cc2.png
通过在网关端口输入路径即可通过断言调取对应服务的接口。https://i-blog.csdnimg.cn/direct/aa305b631f7a4f31b4d649b0c1eb4ad4.png
三、路由断言

https://i-blog.csdnimg.cn/direct/5dc0f4f2ec894beaa34eff8045a79dec.png
现在是通过application.yml配置路由工厂。但使用动态路由需要重写实现路由工厂类，以及使用同一的格式便于规范数据库中路由信息，纵然用args+name，为方便后续章节理解，使用args+name替换gateway的application.yml，内容如下：
server:
port: @gateway.port@
spring:
application:
    name: gateway
cloud:
    nacos:
      server-addr: localhost:8848
      discovery:
      namespace: @namespace@
    gateway:
      routes:
      - id: user-service
          uri:
            lb://user-service
          predicates:
            - name: Path
            args:
                _genkey_0: /user/**

      - id: order-service
          uri:
            lb://order-service
          predicates:
            - name: Path
            args:
                _genkey_0: /order/** 测试通过
https://i-blog.csdnimg.cn/direct/d4d929c59bc84a11abec312301b33d91.png
四、路由过滤器

https://i-blog.csdnimg.cn/direct/17178763f4d2457e9c22a6d08edba1b0.png
后续鉴权模块需要配合网关的过滤器一起搭配使用才能实现不同脚色不同权限访问对应服务/端口，需要手写代码实现 AbstractGatewayFilterFactory，现在先通过yml配置文件为网关添加过滤器方便后续理解。
修改网关模块的yml文件如下：（现在的yml其实就已经很长了，后续必然需要使用代码联合数据库代替配置文件）
server:
port: @gateway.port@
spring:
application:
    name: gateway
cloud:
    nacos:
      server-addr: localhost:8848
      discovery:
      namespace: @namespace@
    gateway:
      routes:
      - id: user-service
          uri:
            lb://user-service
          predicates:
            - name: Path
            args:
                _genkey_0: /user/**
          filters:
            - name: AddRequestHeader
            args:
                name: source
                value: request user from gateway
      - id: order-service
          uri:
            lb://order-service
          predicates:
            - name: Path
            args:
                _genkey_0: /order/**
          filters:
            - name: AddRequestHeader
            args:
                name: source
                value: request order from gateway 为了获取哀求头内容，对OrderController和UserController举行修改。直接替换成下面内容即可。
package cn.bit.orderservice.controller;

import cn.bit.common.pojo.vo.OrderInfoVO;
import cn.bit.common.pojo.vo.R;
import cn.bit.orderservice.service.OrderService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@Slf4j
@RestController
@RequestMapping("/order")
public class OrderController {
    @Autowired
    private OrderService orderService;
    @GetMapping("/test/{id}")
    public String test(@PathVariable Integer id) {
      System.out.println(id);
      return id.toString();
    }

    @GetMapping("/info/{id}")
    public R getOrderInfoById(@PathVariable Integer id, @RequestHeader(value = "source",required = false) String source) {
      log.debug("debug");
      log.info("info");
      log.warn("warning");
      System.out.println(source);
      OrderInfoVO orderInfoVO = orderService.getOrderInfoById(id);
      if (orderInfoVO == null) {
            return R.failed("订单不存在");
      }
      else
            return R.ok(orderInfoVO);
    }
}
package cn.bit.userservice.controller;

import cn.bit.common.pojo.dto.UserBaseInfoDTO;
import cn.bit.common.pojo.vo.R;
import cn.bit.common.pojo.vo.UserFavorVO;
import cn.bit.userservice.config.PatternProperties;
import cn.bit.userservice.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;

    @Autowired
    private PatternProperties patternProperties;

    @GetMapping("/test/{id}")
    public String test(@PathVariable Integer id) {
      System.out.println(id);
      return id.toString()+" "+LocalDateTime.now().format(DateTimeFormatter.ofPattern(patternProperties.getDateformat()));
    }

    @GetMapping("/favor/{id}")
    public R getUserFavorById(@PathVariable Integer id) {
      UserFavorVO vo = userService.getUserFavorById(id);
      if(vo != null) {
            return R.ok(vo);
      }
      else
            return R.failed("用户不存在");
    }

    @GetMapping("/baseInfo/{id}")
    public R getUserBaseInfoById(@PathVariable Integer id, @RequestHeader(value = "source",required = false) String source) {
      System.out.println("get request");
      System.out.println(source);
      UserBaseInfoDTO dto = userService.getUserBaseInfoById(id);
      if(dto != null) {
            return R.ok(dto);
      }
      else
            return R.failed("用户不存在");
    }
}
启动服务
https://i-blog.csdnimg.cn/direct/502b1afee8794f7793b27b9ab4491923.png
先访问user接口即localhost:1233/user/baseInfo/1
https://i-blog.csdnimg.cn/direct/de7358b783d64914a973eccc8433cd3a.png
能够验证确实添加了哀求头
https://i-blog.csdnimg.cn/direct/d647ef4546ed46ca8d8e3b0ab4c8a93d.png
再访问order接口即localhost:1233/order/info/1
https://i-blog.csdnimg.cn/direct/1a918302ebe649f8a0545d2591bb212b.png
发现order-service获取到哀求头，user-service为null，由于网关只对访问order-service的request添加了哀求头，order-service之后使用feign访问的user-service，自然没有哀求头。
https://i-blog.csdnimg.cn/direct/83f663209442421b9e28cabae8f03ed0.png
https://i-blog.csdnimg.cn/direct/40be856893ef4c10b301b7599c408a57.png
为了实现调用朔源可以修改UserClient的接口方法
https://i-blog.csdnimg.cn/direct/079809098d72452b9ee7350ef9745183.png
以及其调用
https://i-blog.csdnimg.cn/direct/66b43ac3efcd48eeac1115f9d16cfae0.png
再次启动服务调用
https://i-blog.csdnimg.cn/direct/f136c70797d241bf8b2f5b854c51f87a.png
五、全局过滤器

之前的过滤器为每个路由的过滤器，而全局过滤器无论使用哪条路由均需要使用。配置如下：
在网关模块创建filter包以及AuthorizeFilter类，内容如下：
package cn.bit.gateway.filter;

import org.springframework.cloud.gateway.filter.GatewayFilterChain;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.core.annotation.Order;
import org.springframework.http.HttpStatus;
import org.springframework.http.server.reactive.ServerHttpRequest;
import org.springframework.stereotype.Component;
import org.springframework.util.MultiValueMap;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

@Order(-1)
@Component
public class AuthorizeFilter implements GlobalFilter {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
      ServerHttpRequest request = exchange.getRequest();
      MultiValueMap<String, String> queryParams = request.getQueryParams();
      String token = queryParams.getFirst("token");
      if("admin".equals(token)) {
            return chain.filter(exchange);
      }
      exchange.getResponse().setStatusCode(HttpStatus.UNAUTHORIZED);
      return exchange.getResponse().setComplete();
    }
}
重启后发现只有哀求参数包含token字段且值为token才能访问对应服务。
https://i-blog.csdnimg.cn/direct/4bf1403e2bba4070a41b920cd2ee8b88.png
https://i-blog.csdnimg.cn/direct/4cfb96fd0a0149aea117bb6a52fe1a9e.png
六、过滤器执行顺序

https://i-blog.csdnimg.cn/direct/b368436f8b1340b8b1b0f5773504018d.png
https://i-blog.csdnimg.cn/direct/11b240d7547940a090717b700aef5f21.png
最后：

黑马课程关于网关模块讲解还是比力浅显，和企业实际应用有较大出入，后续会研究动态路由实现以及鉴权模块，这两模块比力复杂以是后续更新会慢些。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

查看完整版本: 从零搭建微服务项目（第7章——微服务网关模块底子实现）