后端项目初始化

跑通项目

创建一个Spring Cloud项目结构如下

application.yml配置如下

# 公共配置文件
# @author cyr
# 
spring:
  application:
    name: cyroj-user-service
  profiles:
    active: dev
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/cyroj
    username: root
    password: 123456
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
server:
  address: 0.0.0.0
  port: 8102
  servlet:
    context-path: /api/user
mybatis-plus:
  configuration:
    map-underscore-to-camel-case: false
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

写一个Controller接口尝试运行项目

@RestController
@RequestMapping("/")
@Slf4j
public class UserController {

    @GetMapping("/test")
    public String test() {
        return "hello world";
    }
}

成功运行项目！
![image.png]

上传项目到GitHub：https://blog.csdn.net/Saintmm/article/details/122213995

使用代码生成器 mybatisX生成通用代码，将代码复制到对应的模块中。

nacos注册中心

1、导入服务发现依赖

<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2、配置nacos

spring:
	cloud:
		nacos:
			discovery:
				server-addr: 127.0.0.1:8848

微服务网关

微服务网关（cyroj-gateway）：Gateway 聚合所有的接口，统一接受处理前端的请求
为什么需要网关

所有的服务端口不同，增大了前端调用成本
所有服务是分散的，你可需要集中进行管理、操作，比如集中解决跨域、鉴权、接口文档、服务的路由、接口安全性、流量染色、限流

Gateway 和 Nginx 的区别

Gateway 是应用层网关：会有一定的业务逻辑（比如根据用户信息判断权限）
Nginx 是接入层网关：比如每个请求的日志，通常没有业务逻辑

1、引入依赖

<!-- Spring cloud gateway 网关依赖-->
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-gateway</artifactId>
  <version>3.1.3</version>
</dependency>
<dependency>
  <groupId>org.springframework.cloud</groupId>
  <artifactId>spring-cloud-starter-loadbalancer</artifactId>
  <version>3.1.5</version>
</dependency>

2、配置网关

spring:
  cloud:
    gateway:
      routes:
        - id: cyroj-user-service
          uri: lb://cyroj-user-service
          predicates:
            - Path=/api/user/**
        - id: cyroj-question-service
          uri: lb://cyroj-question-service
          predicates:
            - Path=/api/question/**
        - id: cyroj-judge-service
          uri: lb://cyroj-judge-service
          predicates:
            - Path=/api/judge/**

聚合文档

1、网关引入依赖

<dependency>
  <groupId>com.github.xiaoymin</groupId>
  <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
  <version>4.3.0</version>
</dependency>

2、网关引入配置

knife4j:
  gateway:
    enabled: true
    # 指定服务发现的模式聚合微服务文档，并且是默认`default`分组
    strategy: discover
    discover:
      enabled: true
      # 指定版本号(Swagger2|OpenAPI3)
      version : swagger2
      # 需要排除的微服务(eg:网关服务)

3、其它服务引入依赖

<dependency>
  <groupId>com.github.xiaoymin</groupId>
  <artifactId>knife4j-openapi2-spring-boot-starter</artifactId>
  <version>4.3.0</version>
</dependency>

4、其它服务引入配置

knife4j:
  enable: true

访问网关地址即可查看聚合接口文档：http://localhost:8101/doc.html

跨域问题

在网关服务全局解决跨域配置

@Configuration
public class CorsConfig {

    @Bean
    public CorsWebFilter corsFilter() {
        CorsConfiguration config = new CorsConfiguration();
        config.addAllowedMethod("*");
        config.setAllowCredentials(true);
        // todo 实际改为线上真实域名、本地域名
        config.setAllowedOriginPatterns(Arrays.asList("*"));
        config.addAllowedHeader("*");
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(new PathPatternParser());
        source.registerCorsConfiguration("/**", config);
        return new CorsWebFilter(source);
    }
}

今日小结

完成了网关模块和用户模块的相关功能，能通过网关地址访问到用户模块的接口。
下一个任务是完成题目模块的相关功能（核心业务）。

今日遇到的问题
1、小错误：java: 警告: 源发行版 17 需要目标发行版 17
解决方法1：下图所示，修改到jdk8即可，缺点是每次启动都会回到jdk17

解决方法2：添加以下到pom.xml

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.8.1</version>
        <configuration>
            <source>1.8</source>
            <target>1.8</target>
            <encoding>UTF-8</encoding>
        </configuration>
    </plugin>
</plugins>

2、遇到一个坑：gateway网关访问其它服务出现503错误，即使该服务已经注册到nacos上
原因：网关服务配置文件中使用到了 lb:// 语法，需要引入依赖 loadbalancer 负载均衡，而低版本的网关内嵌的是ribbin 负载均衡。
解决方法：提高网关依赖的版本号，或者引入依赖 loadbalancer。

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
    <version>3.1.5</version>
</dependency>