这篇文章，主要介绍如何使用Spring Cloud微服务组件从0到1搭建一个微服务工程。

目录

一、从0到1搭建微服务工程

1.1、基础环境说明

（1）使用组件

（2）微服务依赖

1.2、搭建注册中心

（1）引入依赖

（2）配置文件

（3）启动类

1.3、搭建配置中心

（1）引入依赖

（2）配置文件

（3）启动类

1.4、搭建API网关

（1）引入依赖

（2）配置文件

（3）启动类

1.5、搭建服务提供者

（1）引入依赖

（2）配置文件

（3）启动类

1.6、搭建服务消费者

（1）引入依赖

（2）配置文件

（3）启动类

1.7、运行测试

---

一、从0到1搭建微服务工程

1.1、基础环境说明

（1）使用组件

这里主要是使用的Spring Cloud Netflix微服务组件搭建工程，其中需要搭建下面这些组件工程：

• 注册中心：采用Eureka实现注册中心。
• 配置中心：采用Spring Cloud Config实现配置中心。
• API网关：采用Spring Cloud Gateway作为网关。
• 服务调用：采用OpenFeign实现服务之间的调用。
• 负载均衡：采用Ribbon实现服务的负载均衡。

大致如下所示：

工程代码结构：

（2）微服务依赖

<!-- 引入SpringBoot依赖 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.12.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

<dependencyManagement>
    <!-- 使用 dependencyManagement 依赖管理，统一管理组件的版本 -->
    <dependencies>
        <!-- 引入 SpringCloud 微服务依赖 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Hoxton.SR12</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

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

1.2、搭建注册中心

这里采用单机的Eureka注册中心，当然也可以使用集群的Eureka注册中心。

（1）引入依赖

<!-- 引入 eureka 服务端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>

（2）配置文件

server:
  port: 8761
spring:
  application:
    name: cloud-eureka-server
# 配置 eureka 服务端
eureka:
  client:
    register-with-eureka: false # 是否将自己注册到eureka注册中心
    fetch-registry: false # 是否从eureka注册中心获取注册信息

（3）启动类

package com.gitcode.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

/**
 * @version 1.0.0
 * @Date: 2023/4/26 20:27
 * @Copyright (C) ZhuYouBin
 * @Description: Eureka 注册中心服务端启动类
 */
@EnableEurekaServer
@SpringBootApplication
public class EurekaApp {
    public static void main(String[] args) {
        SpringApplication.run(EurekaApp.class, args);
    }
}

1.3、搭建配置中心

采用Spring Cloud Config组件实现配置中心的功能。

（1）引入依赖

<!-- 引入 eureka 客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<!-- 引入 config-server 服务端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-server</artifactId>
</dependency>

（2）配置文件

server:
  port: 8888
spring:
  application:
    name: cloud-config-server
  cloud:
    config:
      server:
        git:
          uri: https://gitcode.net/qq_39826207/config-demo.git # Git仓库的地址
#          username: # Git仓库的登录用户名称
#          password: # Git仓库的登录密码
#          default-label: # 默认访问的分支名称
#          search-paths: # 搜索的根目录，从仓库中的哪个目录中开始查找配置文件

# eureka 配置
eureka:
  instance:
    hostname: ${spring.application.name}
    prefer-ip-address: true # 开启采用 IP 注册形式
    # ${spring.cloud.client.ip-address} 这个属性可以获取到当前机器的 IP 地址
    instance-id: ${spring.cloud.client.ip-address}:${server.port} # 设置当前服务的实例ID，采用：IP+端口形式
  client:
    register-with-eureka: true # 是否将自己注册到eureka注册中心
    fetch-registry: true # 是否从eureka注册中心获取注册信息
    service-url:
      defaultZone: http://localhost:8761/eureka/ # eureka服务端的地址

（3）启动类

package com.gitcode.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.config.server.EnableConfigServer;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

/**
 * @version 1.0.0
 * @Date: 2023/4/26 20:37
 * @Copyright (C) ZhuYouBin
 * @Description: Config 配置中心服务端启动类
 */
@EnableConfigServer
@EnableEurekaClient
@SpringBootApplication
public class ConfigApp {
    public static void main(String[] args) {
        SpringApplication.run(ConfigApp.class, args);
    }
}

1.4、搭建API网关

采用Spring Cloud Gateway实现API网关的功能。

（1）引入依赖

<!-- 引入 eureka 客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<!-- 引入 Gateway 依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

（2）配置文件

server:
  port: 8080
spring:
  application:
    name: cloud-api-gateway
  cloud:
    gateway:
      # 动态服务转发
      discovery:
        locator:
          enabled: true # 启用动态路由服务名称转发功能
          lower-case-service-id: true # 开启服务名称小写

# eureka 配置
eureka:
  instance:
    hostname: ${spring.application.name}
    prefer-ip-address: true # 开启采用 IP 注册形式
    # ${spring.cloud.client.ip-address} 这个属性可以获取到当前机器的 IP 地址
    instance-id: ${spring.cloud.client.ip-address}:${server.port} # 设置当前服务的实例ID，采用：IP+端口形式
  client:
    register-with-eureka: true # 是否将自己注册到eureka注册中心
    fetch-registry: true # 是否从eureka注册中心获取注册信息
    service-url:
      defaultZone: http://localhost:8761/eureka/ # eureka服务端的地址

（3）启动类

package com.gitcode.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

/**
 * @version 1.0.0
 * @Date: 2023/4/26 20:49
 * @Copyright (C) ZhuYouBin
 * @Description: Gateway 网关启动类
 */
@EnableEurekaClient
@SpringBootApplication
public class GatewayApp {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApp.class, args);
    }
}

1.5、搭建服务提供者

（1）引入依赖

<!-- 引入 web 依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 引入 eureka 客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<!-- 引入 config-client 客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-client</artifactId>
</dependency>

（2）配置文件

• 注意：这里创建的配置文件必须是【bootstrap.yml】，因为需要从配置中心获取配置信息。

server:
  port: 6250
spring:
  application:
    name: biz-provider
  cloud:
    config:
      name: biz-provider # 从 Git 仓库获取的配置文件名称
      label: master # 从哪个分支获取
      profile: dev # 获取哪个环境下的配置文件
      # 从注册中心获取配置信息
      discovery:
        enabled: true # 开启服务发现的功能，这里也就是支持eureka的功能
        service-id: cloud-config-server # config server服务端的微服务应用名称

（3）启动类

package com.gitcode.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

/**
 * @version 1.0.0
 * @Date: 2023/4/26 20:57
 * @Copyright (C) ZhuYouBin
 * @Description: 服务提供者启动类
 */
@EnableEurekaClient
@SpringBootApplication
public class ProviderApp {
    public static void main(String[] args) {
        SpringApplication.run(ProviderApp.class, args);
    }
}

1.6、搭建服务消费者

服务消费者需要调用服务提供者的接口，所以这里需要引入OpenFeign组件。

（1）引入依赖

<!-- 引入 web 依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 引入 eureka 客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<!-- 引入 config-client 客户端依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-client</artifactId>
</dependency>
<!-- 引入 OpenFeign 依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

（2）配置文件

• 注意：这里创建的配置文件必须是【bootstrap.yml】，因为需要从配置中心获取配置信息。

server:
  port: 9527
spring:
  application:
    name: biz-consumer
  cloud:
    config:
      name: biz-consumer # 从 Git 仓库获取的配置文件名称
      label: master # 从哪个分支获取
      profile: dev # 获取哪个环境下的配置文件
      # 从注册中心获取配置信息
      discovery:
        enabled: true # 开启服务发现的功能，这里也就是支持eureka的功能
        service-id: cloud-config-server # config server服务端的微服务应用名称

（3）启动类

package com.gitcode.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

/**
 * @version 1.0.0
 * @Date: 2023/4/26 21:11
 * @Copyright (C) ZhuYouBin
 * @Description: 服务消费者启动类
 */
@EnableFeignClients
@EnableEurekaClient
@SpringBootApplication
public class ConsumerApp {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApp.class, args);
    }
}

1.7、运行测试

依次启动Eureka注册中心、Config配置中心、Gateway网关、Consumer服务消费者、Provider服务提供者，查看注册中心是否正常。

浏览器，通过Gateway访问Consumer消费者工程中的接口【http://localhost:8080/biz-consumer/api/consumer/getUserInfo】，注意：测试接口的代码没有贴出来，可以到我的代码仓库里面查看。

到此，从0到1的微服务工程搭建完成。

综上，这篇文章结束了，主要介绍如何使用Spring Cloud微服务组件从0到1搭建一个微服务工程【源代码】。