搭建你的第一个Spring Cloud Alibaba微服务

Spring Cloud Alibaba是Spring Cloud生态中的一员，提供了许多高效的工具来支持微服务架构下的分布式系统，比如服务注册与发现、配置中心、熔断器、消息驱动等。本文将带你一步步搭建一个简单的Spring Cloud Alibaba项目。

前置条件

在开始之前，请确保您的开发环境已准备好以下工具：

1. Java Development Kit (JDK) 8或更高版本
2. Maven 或 Gradle：项目构建工具
3. IDE：如IntelliJ IDEA，Eclipse等
4. Docker（可选）：用于容器化部署

搭建步骤

一、创建Spring Boot项目

首先，我们需要创建一个Spring Boot项目，作为我们的微服务基础。推荐使用Spring Initializr工具。

1. 访问Spring Initializr。
2. 填写项目信息：
- • Project: Maven Project
- • Language: Java
- • Spring Boot: 最新稳定版本
- • Group: com.example
- • Artifact: springcloud-alibaba-demo
- • Dependencies: Spring Web
3. 点击“Generate”下载生成的项目，并解压缩。

二、引入Spring Cloud Alibaba依赖

要在Spring Boot项目中使用Spring Cloud Alibaba，需要在pom.xml中添加相关依赖。

• 首先，添加Spring Cloud Alibaba的BOM依赖：

<dependencyManagement><dependencies><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-alibaba-dependencies</artifactId><version>2.2.6.RELEASE</version> <!-- 选择合适的版本 --><type>pom</type><scope>import</scope></dependency></dependencies>
</dependencyManagement>

• 添加Nacos作为配置中心和服务发现的依赖：

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

三、设置Nacos

1. 启动Nacos Server

你可以通过Docker快速启动Nacos：

docker run -d --name nacos-server -e MODE=standalone -p 8848:8848 nacos/nacos-server

2. 配置Spring Boot应用

在项目的src/main/resources/application.yml中配置Nacos：

spring:application:name: alibaba-democloud:nacos:discovery:server-addr: localhost:8848config:server-addr: localhost:8848file-extension: yaml

四、实现服务注册与发现

在主类文件中（例如，DemoApplication.java），启用服务发现功能：

package com.example.alibabademo;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;@SpringBootApplication
@EnableDiscoveryClient
public class DemoApplication {public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}

五、测试服务注册与发现

1. 确保Nacos Server正在运行。
2. 启动你的Spring Boot应用。
3. 访问Nacos控制台http://localhost:8848/nacos，登录后你会看到应用注册的服务实例。

六、使用Nacos作为配置中心

在Nacos控制台中，添加新的配置。使用以下内容创建一个配置文件 /application.yaml：

test:message: "Hello from Nacos Configuration"

然后，在你的Spring Boot应用中，创建一个简单的RestController来读取这个配置：

package com.example.alibabademo;import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class ConfigTestController {@Value("${test.message}")private String message;@GetMapping("/message")public String message() {return this.message;}
}