Spring Cloud Alibaba 微服务架构：从开发到部署的全攻略

news/2025/2/24 10:16:31/文章来源:https://www.cnblogs.com/java-note/p/18733461

一、环境准备

在开始集成之前，确保你的开发环境已经具备以下条件：

1. Java 环境

安装 JDK 1.8 或更高版本。Java 是 Spring Boot 和 Spring Cloud Alibaba 的运行基础，确保你的开发环境已正确安装并配置 JDK。你可以通过以下命令验证 JDK 是否安装成功：

java -version

2. Maven 或 Gradle

使用 Maven 或 Gradle 作为项目的构建工具。它们不仅能够帮助你管理项目依赖，还能简化项目的构建和部署流程。对于 Maven，确保你已正确安装并配置了 MAVEN_HOME 环境变量，可以通过以下命令验证：

mvn -v

3. Nacos 服务端

Nacos 是 Spring Cloud Alibaba 的核心组件之一，用于服务注册、发现和配置管理。在集成之前，请确保你已经安装并启动了 Nacos 服务端。你可以通过以下命令启动 Nacos：

java -jar nacos-server-x.x.x.jar --spring.profiles.active=standalone

默认情况下，Nacos 的服务端运行在 8848 端口上，你可以通过浏览器访问 http://localhost:8848/nacos 来验证 Nacos 是否启动成功。

4. 开发工具

推荐使用 IntelliJ IDEA 或 Eclipse 等支持 Spring Boot 的开发工具，它们提供了丰富的插件和代码提示功能，能够显著提升开发效率。如果你使用的是 IntelliJ IDEA，可以通过其内置的 Spring Initializr 快速生成 Spring Boot 项目。

二、集成步骤

（一）创建父工程

  1. 创建 Maven 父项目
    创建一个 Maven 父项目，用于统一管理多个微服务模块。在父项目的 pom.xml 文件中，添加 Spring Boot 和 Spring Cloud Alibaba 的依赖管理：
<properties><java.version>1.8</java.version><spring-boot.version>2.2.5.RELEASE</spring-boot.version><spring-cloud-alibaba.version>2.2.1.RELEASE</spring-cloud-alibaba.version>
</properties><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>${spring-boot.version}</version>
</parent><dependencyManagement><dependencies><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>

这一步为后续模块的开发提供了统一的依赖管理，确保版本一致性和兼容性。

（二）添加服务发现组件（Nacos）

服务发现是微服务架构的核心功能之一，它允许服务之间通过动态注册和发现的方式进行通信。Nacos 作为 Spring Cloud Alibaba 的服务发现组件，提供了强大的服务注册和发现能力。

  1. 添加 Nacos 依赖
    在每个微服务模块的 pom.xml 文件中，添加 Nacos 的依赖：
<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
  1. 配置 Nacos 服务地址
    在微服务模块的 application.yml 配置文件中，指定 Nacos 服务端的地址：
spring:application:name: your-service-namecloud:nacos:discovery:server-addr: 127.0.0.1:8848

这里，your-service-name 是你的微服务名称，server-addr 是 Nacos 服务端的地址和端口。

  1. 启用服务发现功能
    在微服务的启动类上，添加 @EnableDiscoveryClient 注解，使服务能够自动注册到 Nacos 并支持服务发现：
@SpringBootApplication
@EnableDiscoveryClient
public class YourServiceApplication {public static void main(String[] args) {SpringApplication.run(YourServiceApplication.class, args);}
}

现在，你的微服务已经具备了注册和发现的能力，可以在 Nacos 控制台中看到服务的注册信息。

示例：服务提供者与消费者

  • 服务提供者：

    @RestController
public class ProviderController {@GetMapping("/hello")public String hello() {return "Hello from Provider!";}
}

  • 服务消费者：
    使用 @LoadBalanced 注解的 RestTemplate 调用服务提供者：

    @RestController
public class ConsumerController {@Autowiredprivate RestTemplate restTemplate;@GetMapping("/consume")public String consume() {return restTemplate.getForObject("http://your-service-name/hello", String.class);}
}

（三）添加配置管理组件（可选）

在微服务架构中，配置管理是一个重要的环节。Spring Cloud Alibaba 提供了基于 Nacos 的集中配置管理功能，可以实现配置的动态更新和管理。

  1. 添加配置管理依赖
    在需要使用配置管理的微服务模块中，添加 Nacos 配置管理的依赖：
<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
  1. 配置 Nacos 配置中心
    在 application.yml 文件中，添加 Nacos 配置中心的地址：
spring:cloud:nacos:config:server-addr: 127.0.0.1:8848

启动应用后，微服务会从 Nacos 配置中心拉取配置信息，并支持动态更新。

  1. 动态配置示例
    在 Nacos 控制台中创建一个配置文件，例如 your-service-name.yaml，并添加以下内容：
your:config:value: "This is a dynamic config value"

在微服务中，使用 @Value 注解读取动态配置：

@RestController
public class ConfigController {@Value("${your.config.value}")private String configValue;@GetMapping("/config")public String getConfig() {return "Dynamic Config Value: " + configValue;}
}

修改 Nacos 中的配置后，无需重启服务即可实时生效。

（四）集成其他组件

Spring Cloud Alibaba 提供了丰富的微服务组件，如熔断限流（Sentinel）、消息队列（RocketMQ）等，可以根据需求进行集成。

1. 集成 Sentinel（熔断限流）

Sentinel 是一个流行的熔断限流框架，可以保护微服务免受流量冲击。

  • 添加 Sentinel 依赖：

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

  • 配置 Sentinel：

    spring:cloud:sentinel:transport:dashboard: localhost:8080

  • 使用 Sentinel 注解：
    在需要保护的方法上添加 @SentinelResource 注解，例如：

    @RestController
public class SentinelController {@SentinelResource("protectedMethod")@GetMapping("/protected")public String protectedMethod() {return "This method is protected by Sentinel";}
}

    Sentinel 提供了丰富的规则配置，如流量控制、熔断降级和系统保护等，可以通过 Sentinel 控制台进行动态配置。

2. 集成 RocketMQ（消息队列）

RocketMQ 是一个高性能的消息中间件，适用于分布式系统中的异步通信。

  • 添加 RocketMQ 依赖：

    <dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-stream-rocketmq</artifactId>
</dependency>

  • 配置 RocketMQ：

    spring:cloud:stream:rocketmq:binder:name-server: localhost:9876bindings:output:destination: my-topic

  • 发送和接收消息：
    使用 Spring Cloud Stream 提供的 Source 和 Sink 接口，可以轻松实现消息的发送和接收。

    消息发送方：

    @RestController
public class MessageController {@Autowiredprivate Source source;@GetMapping("/send")public String sendMessage() {source.output().send(MessageBuilder.withPayload("Hello RocketMQ!").build());return "Message sent successfully!";}
}

    消息接收方：

    @Component
public class MessageListener {@StreamListener("input")public void receiveMessage(String message) {System.out.println("Received message: " + message);}
}

三、最佳实践

在实际开发中，遵循以下最佳实践可以提升微服务系统的稳定性和可维护性：

  1. 合理拆分服务
    根据业务需求合理拆分微服务，避免服务过于庞大或过于碎片化。每个微服务应专注于单一的业务功能，便于开发和维护。例如，一个电商系统可以拆分为用户服务、订单服务、支付服务等。

  2. 配置中心化
    使用 Nacos 集中管理配置，实现配置的动态更新和版本管理。避免将配置硬编码在代码中，便于后续的维护和扩展。例如，可以通过 Nacos 动态调整服务的超时时间或数据库连接信息。

  3. 服务监控
    集成 Spring Boot Actuator，监控服务的健康状态、性能指标和运行日志。通过可视化工具（如 Prometheus 和 Grafana）进一步提升监控能力。例如，通过 Grafana 可视化服务的响应时间、吞吐量等指标。

  4. 服务容错
    使用 Sentinel 提供熔断和限流功能，防止服务过载和雪崩效应。合理配置熔断规则和限流策略，确保系统的稳定性。例如，当某个服务的流量超过阈值时，自动触发限流策略，避免服务崩溃。

  5. 链路追踪
    集成 Spring Cloud Sleuth，实现服务调用链的追踪。通过追踪日志，快速定位问题和性能瓶颈。例如，通过 Sleuth 可以追踪一个订单创建请求的完整调用链，包括用户服务、订单服务和支付服务的交互。

  6. 安全性
    在微服务之间通信时，使用 HTTPS 和身份认证机制（如 OAuth2），确保数据的安全性和完整性。例如，通过 OAuth2 为每个服务提供安全的认证和授权机制。

示例代码

为了方便读者更好地理解和实践，以下是完整的示例代码：

1. 父项目 pom.xml

<properties><java.version>1.8</java.version><spring-boot.version>2.2.5.RELEASE</spring-boot.version><spring-cloud-alibaba.version>2.2.1.RELEASE</spring-cloud-alibaba.version>
</properties><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>${spring-boot.version}</version>
</parent><dependencyManagement><dependencies><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>

2. 服务提供者 pom.xml

<dependencies><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
</dependencies>

3. 服务提供者 application.yml

spring:application:name: service-providercloud:nacos:discovery:server-addr: 127.0.0.1:8848

4. 服务提供者 ProviderController.java

@RestController
public class ProviderController {@GetMapping("/hello")public String hello() {return "Hello from Provider!";}
}

5. 服务消费者 pom.xml

<dependencies><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
</dependencies>

6. 服务消费者 application.yml

spring:application:name: service-consumercloud:nacos:discovery:server-addr: 127.0.0.1:8848

7. 服务消费者 ConsumerController.java

@RestController
public class ConsumerController {@Autowiredprivate RestTemplate restTemplate;@Bean@LoadBalancedpublic RestTemplate restTemplate() {return new RestTemplate();}@GetMapping("/consume")public String consume() {return restTemplate.getForObject("http://service-provider/hello", String.class);}
}

8. 配置管理示例

Nacos 配置文件 service-provider.yaml

your:config:value: "This is a dynamic config value"

服务提供者 ConfigController.java

@RestController
public class ConfigController {@Value("${your.config.value}")private String configValue;@GetMapping("/config")public String getConfig() {return "Dynamic Config Value: " + configValue;}
}

9. Sentinel 示例

添加 Sentinel 依赖

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

配置 Sentinel

spring:cloud:sentinel:transport:dashboard: localhost:8080

使用 Sentinel 注解

@RestController
public class SentinelController {@SentinelResource("protectedMethod")@GetMapping("/protected")public String protectedMethod() {return "This method is protected by Sentinel";}
}

10. RocketMQ 示例

添加 RocketMQ 依赖

<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-stream-rocketmq</artifactId>
</dependency>

配置 RocketMQ

spring:cloud:stream:rocketmq:binder:name-server: localhost:9876bindings:output:destination: my-topic

消息发送方

@RestController
public class MessageController {@Autowiredprivate Source source;@GetMapping("/send")public String sendMessage() {source.output().send(MessageBuilder.withPayload("Hello RocketMQ!").build());return "Message sent successfully!";}
}

消息接收方

@Component
public class MessageListener {@StreamListener("input")public void receiveMessage(String message) {System.out.println("Received message: " + message);}
}

五、实际应用场景

场景一：电商系统

假设你正在开发一个电商系统，需要拆分为多个微服务，例如：

  1. 用户服务：管理用户信息，如注册、登录和用户资料。
  2. 订单服务：处理订单创建、查询和取消。
  3. 支付服务：处理支付流程，与第三方支付平台对接。

通过 Spring Boot 和 Spring Cloud Alibaba，你可以轻松实现这些服务的注册、发现和通信。例如，订单服务可以通过调用用户服务获取用户信息，支付服务可以通过调用订单服务确认订单状态。

场景二：企业级应用

在企业级应用中，你可能需要动态配置服务的行为。例如，根据业务需求调整服务的超时时间或数据库连接池大小。通过 Nacos 的配置管理功能，你可以在不重启服务的情况下动态更新这些配置。

场景三：高并发系统

在高并发场景下，服务可能会面临流量过载的风险。通过集成 Sentinel，你可以为服务设置流量控制和熔断规则，确保系统在高流量下依然稳定运行。例如，当订单服务的流量超过每秒 100 次请求时，自动触发限流策略，避免服务崩溃。

六、常见问题与解决方案

1. Nacos 无法连接

如果 Nacos 无法连接，可能是 Nacos 服务端未正确启动，或者配置的地址不正确。请检查 Nacos 是否已成功启动，并确保 application.yml 中的 server-addr 配置正确。

2. 服务未注册到 Nacos

如果服务未注册到 Nacos，可能是缺少 @EnableDiscoveryClient 注解。请确保在服务的启动类上添加了该注解。

3. Sentinel 无法生效

如果 Sentinel 的熔断或限流规则无法生效，可能是 Sentinel 控制台未正确配置。请确保 Sentinel 控制台已启动，并且服务的 transport.dashboard 配置正确。

4. RocketMQ 消息丢失

如果 RocketMQ 消息丢失，可能是消息队列的配置不正确，或者消费者未正确订阅主题。请检查 RocketMQ 的配置，并确保消费者使用了正确的主题和标签。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/888911.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

【草稿】图片上传2

【草稿】图片上传2

本随笔用于上传图片 博客园居然不压缩图片，有点太良心了，我还得手动去压缩一遍。
阅读更多...
word

word

选项卡的折叠和固定功能区快捷键：Ctrl+F1后退一步和前进一步的快捷键分别是：Ctrl+z、Ctrl+y页面放大和缩小命令：按住Ctrl，滚动鼠标滚轮，点击右下角的百分比，弹出显示比例对话框，可以选择一个比例，点击确定也可以实现，如下图：新建word命令，可以页面右击新建，也可以在…
阅读更多...
idea连接sqlserver出现[08S01] 驱动程序无法通过使用安全套接字层(SSL)加密与 SQL Server 建立安全连接错误（转）

idea连接sqlserver出现[08S01] 驱动程序无法通过使用安全套接字层(SSL)加密与 SQL Server 建立安全连接错误（转）

错误信息 选择对应的DataSource 修改两个地方即可 修改Advanced页签的trustServerCertificate 在使用 JDBC 连接 SQL Server 数据库时，trustServerCertificate 是一个连接参数，用于指示客户端是否信任服务器端的证书。当 trustServerCertificate 参数设置为 true 时，客…
阅读更多...
2025/2/23 LeetCode151. 反转字符串中的单词

2025/2/23 LeetCode151. 反转字符串中的单词

151. 反转字符串中的单词 - 力扣（LeetCode） 之前做的2024/12/14 【字符串】LeetCode151.反转字符串中的单词 【√】知识点：几个易错点，split函数 - axuu - 博客园 这些函数又忘了。 总结split(): 拆分字符串为列表。strip(): 去除字符串两端的空白字符。[::-1]: 反转字符…
阅读更多...
谷歌逐步淘汰V2插件，广告拦截不能用了？

谷歌逐步淘汰V2插件，广告拦截不能用了？

本文是《最全面的浏览器教程》第九篇，介绍目前扩展生态的问题。​ 你的浏览器扩展可能一夜之间失效！快收下这份自救指南。 本文是《最全面的浏览器教程》第九篇，介绍目前扩展生态的问题。 ‍ 起因 Chrome Manifest v2 是 Chrome 扩展程序的一种配置文件格式，是扩展的一部分…
阅读更多...
2024CISCN长城杯wp

2024CISCN长城杯wp

威胁检测与网络流量分析 zeroshell_1 1.解法一：分析流量包 ，提取http对象，找到包含命令的流量包Referer字段很像base64编码，试一试 真是flag2.解法二：CTF_NAT一把梭，找到包含flag的密文，cyberchef解密zeroshell_2 1.解法一：网上找漏洞payload，在url里进行注入，先找fl…
阅读更多...
Debian 11 离线安装MySql记录

Debian 11 离线安装MySql记录

环境：mysql：mysql-8.0.32-linux-glibc2.17-aarch64.tar.gz 1、上传到服务器，然后解压缩 tar -zxvf mysql-8.0.32-linux-glibc2.17-aarch64.tar.gz 2、移动到指定目录/usr/local/mysql-8 mv mysql-8.0.32-linux-glibc2.17-aarch64 /usr/local/mysql-8 3、创建MySQL数据目录 m…
阅读更多...
rds导入excel表格数据

rds导入excel表格数据

阅读更多...
一个支持多家云存储驱动的公有云文件系统！

一个支持多家云存储驱动的公有云文件系统！

Cloudreve —— 一个基于 Go + React 实现的支持多家云存储驱动的公有云文件系统，适用于搭建个人网盘、文件分享系统等。大家好，我是 Java陈序员。 在日常生活中，我们会记录很多精彩的瞬间，或图片或视频，并存放在网盘中。 然而，很多商业网盘下载速度慢，而且不能很好地保…
阅读更多...
传统ftp软件问题频出，一文了解适配的替代方案！

传统ftp软件问题频出，一文了解适配的替代方案！

在互联网发展的早期，ftp软件凭借其简单易用的特性，成为了文件传输领域的中流砥柱，帮助无数企业实现文件的远程传输与共享。时过境迁，在如今数据量呈爆炸式增长、网络环境愈发复杂的时代，ftp软件就像一位上了年纪的老将，逐渐显露出诸多力不从心之处。 1.数据裸奔的安全风…
阅读更多...
原创--记一次配置小米路由器(miwifi)的过程

原创--记一次配置小米路由器(miwifi)的过程

1.登录2.登录后3.4.设置WAN口IP相关信息5.设置LAN口IP相关信息至此，配置完成，打通了LAN口与WAN口之间的数据传输 大概示意图如下： 海阔凭鱼跃，天高任鸟飞，成功没有捷径，唯有努力前行！
阅读更多...
大三下每日打卡002(搭建Android平台和创建HelloWorld并发布apk)

大三下每日打卡002(搭建Android平台和创建HelloWorld并发布apk)

实验一：搭建Android平台和创建HelloWorld 实验目的 本次实验的目的是让大家熟悉搭建智能手机开发平台的过程，了解Andorid开发项目的基本文件目录结构，并实现HelloWorld小例程。 实验要求完成Android开发平台的搭建及相关配置 创建项目并熟悉文件目录结构 实现例程HelloWorld…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023