Spring Boot 单体应用升级 Spring Cloud 微服务

作者：刘军

Spring Cloud 是在 Spring Boot 之上构建的一套微服务生态体系，包括服务发现、配置中心、限流降级、分布式事务、异步消息等，因此通过增加依赖、注解等简单的四步即可完成 Spring Boot 应用到 Spring Cloud 升级。

*Spring Cloud Alibaba (SCA) 官网正式上线：sca.aliyun.com

Spring Boot 应用升级为 Spring Cloud

以下是应用升级 Spring Cloud 的完整步骤。

第一步：添加 Spring Cloud 依赖

首先，为应用添加 Spring Cloud 与 Spring Cloud Alibaba 依赖。注意根据当前应用 Spring Boot 版本选择合适的 Spring Cloud 版本，具体参见版本映射表 [ 1] 。

<properties>
    <spring-cloud-alibaba.version>2022.0.0.0</spring-cloud-alibaba.version>
    <spring-cloud.version>2022.0.0</spring-cloud.version>
</properties>
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>${spring-cloud.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>${spring-cloud-alibaba.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <!-- Nacos 服务发现 -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <!-- 服务发现：OpenFeign服务调用 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>
  <!-- 服务发现：OpenFeign服务调用 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-loadbalancer</artifactId>
    </dependency>
</dependencies>

以上我们添加了服务注册发现、OpenFeign 等依赖。

第二步：添加配置

在应用 application.yml 或者 application.properties 文件中增加以下配置项，设置应用名、注册中心地址。

application.yml：

spring:
  application:
    #项目名称必填，在注册中心唯一
    #最好和之前域名规范、kubernetes service名等保持一致（会作为调用与负载均衡依据）
    name: service-provider
  cloud: 
    nacos: 
      discovery: #启用 spring cloud nacos discovery
        server-addr: 127.0.0.1:8848

application.properties：

#项目名称必填，在注册中心唯一
#最好和之前域名规范、kubernetes service名等保持一致（会作为调用与负载均衡依据）
spring.application.name=service-provider
 #启用 spring cloud nacos discovery
spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848

第三步：启动类增加注解

启动类增加 EnableDiscoveryClient EnableFeignClients 注解，启动服务地址自动注册与发现。

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

第四步：调整服务调用方式

🔔 注意！

• • 如果之前有自定义域名，则和域名定义保持一致
  • 如果之前用的 Kubernetes Service，则和 Service Name 保持一致

1. RestTemplate 模式

为之前的 RestTemplate Bean 添加 @LoadBlanced 注解，使得 RestTemplate 接入服务发现与负载均衡：

@Bean
@LoadBalanced
public RestTemplate restTemplate() {
    return new RestTemplate();
}

其它原有 RestTemplate 发起调用的代码保持不变，只需调整 hostname 即可，如下所示。

@RestController
 public class TestController {

    @Autowired
    private RestTemplate restTemplate;

    @GetMapping(value = "/echo-rest/{str}")
    public String rest(@PathVariable String str) {
        return restTemplate.getForObject("http://service-provider/echo/" + str, String.class);
    }
}

2. FeignClient 模式

使用 @FeignClient 注解将 EchoService 这个接口包装成一个 FeignClient，属性 name 对应对端应用名 spring.name=service-provider。

//@FeignClient(name = "service-provider", url="http://service.example.com/") 
@FeignClient(name = "service-provider")
public interface EchoService {
    @GetMapping(value = "/echo/{str}")
    String echo(@PathVariable("str") String str);
}

将 EchoService 作为标准 bean 注入，即可对远端服务发起请求了。

@RestController
 public class TestController {

    @Autowired
    private EchoService echoService;

    @GetMapping(value = "/echo-feign/{str}")
    public String feign(@PathVariable String str) {
        return echoService.echo(str);
    }
}

3. HtClient、自定义 HTTP 访问工具等

对于使用 HttpClient 或者自行封装 http 调用工具的用户，建议统一改造为以上 1、2 两种调用模式之一。

参考资料

完整示例源码

基于 Spring Boot 构建的应用架构变化多样，比如可能是以下一些常用架构的任意一种，但不论哪种架构，升级 Spring Cloud 的大致改造方式都是类似的（都可以转为基于 Nacos 注册中心的地址发现与负载均衡）。

• 基于 DNS 自定义域名，服务间的通过域名调用实现负载均衡
• 基于 SLB 的中心化流量转发，调用直接转发到 SLB，由 SLB 实现在服务间实现流量转发
• 基于 Kubernetes Service 微服务体系，依赖 Kubernetes ClusterIP 等实现负载均衡与调用转发

在此，我们以 DNS 自定义域名架构为例，提供了一个 Spring Boot 到 Spring Cloud 升级改造的完整示例，升级前后的应用架构图如下。具体可参见 Github 源码链接 [ 2] 。

升级前 SpringBoot 架构 👆

升级后 SpringCloud 架构 👆

Spring Boot 与 Spring Cloud Alibaba 版本对应关系

请根据您使用的 Spring Boot 版本，选择兼容的 Spring Cloud Alibaba 版本：

Spring Cloud Alibaba Starters 列表与使用手册

• spring-cloud-starter-alibaba-nacos-discovery [ 3]
• spring-cloud-starter-alibaba-nacos-config [ 4]
• spring-cloud-starter-alibaba-nacos-sentinel [ 5]
• spring-cloud-starter-alibaba-nacos-rocketmq [ 6]
• spring-cloud-starter-alibaba-nacos-seata [ 7]

Spring Cloud Alibaba 集成的组件版本

每个 Spring Cloud Alibaba 版本及其自身所适配的各组件对应版本如下表所示：

相关链接：

[1] 版本映射表

sca.aliyun.com/zh-cn/docs/…

[2] Github 源码链接

github.com/spring-clou…

[3] spring-cloud-starter-alibaba-nacos-discovery

sca.aliyun.com/zh-cn/docs/…

[4] spring-cloud-starter-alibaba-nacos-config

sca.aliyun.com/zh-cn/docs/…

[5] spring-cloud-starter-alibaba-nacos-sentinel

sca.aliyun.com/zh-cn/docs/…

[6] spring-cloud-starter-alibaba-nacos-rocketmq

sca.aliyun.com/zh-cn/docs/…

[7] spring-cloud-starter-alibaba-nacos-seata

sca.aliyun.com/zh-cn/docs/…