【Spring Cloud Alibaba】基于Spring Boot 3.x 搭建教程

在云原生架构越来越受到欢迎的今天，Spring Cloud 和 Alibaba 提供了一系列的解决方案，可以帮助我们快速构建分布式系统。本文将指导您如何基于 Spring Boot 3.x 搭建一个简单的 Spring Cloud Alibaba 微服务项目。

一、环境准备

首先，确保您的开发环境已安装以下工具：

• JDK 17 或以上
• Maven
• IDE（如 IntelliJ IDEA 或 Eclipse）

二、创建 Spring Boot 项目

您可以通过 Spring Initializr 快速创建一个 Spring Boot 项目，访问Spring Initializr网站，选择如下配置：

• Project: Maven
• Language: Java
• Spring Boot: 3.x.x
• Dependencies: Spring Web, Spring Cloud, Nacos Discovery, Spring Boot DevTools

生成项目后，下载并解压缩，然后导入到您的 IDE 中。

三、添加依赖

在 pom.xml 中添加 Spring Cloud Alibaba 的依赖：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2023.x.x</version> <!-- 替换为最新版本 -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<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

在 src/main/resources/application.yml 中配置 Nacos 的地址：

spring:
  application:
    name: cloud-alibaba-demo
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
      config:
        server-addr: 127.0.0.1:8848

确保您的 Nacos 服务正在本地运行，默认端口为 8848。

五、创建 RESTful API

在 src/main/java/com/example/demo/ 下创建一个控制器 DemoController.java：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DemoController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Cloud Alibaba!";
    }
}

六、注册服务与配置中心

Nacos 不仅可以用于服务发现，还可以作为配置中心。在 Nacos 控制台中，您可以通过配置数据创建一个配置项，例如 application.properties，并在其中定义一些配置：

app.name=cloud-alibaba-demo

然后在 Spring Boot 应用中使用：

@Value("${app.name}")
private String appName;

@GetMapping("/config")
public String config() {
    return "App Name: " + appName;
}

七、启动应用

在 IDE 中运行 DemoApplication 类，启动 Spring Boot 应用。您可以访问 http://localhost:8080/hello 来测试 REST 接口，访问 http://localhost:8080/config 来查看从 Nacos 获取的配置信息。

八、总结

通过以上步骤，您已经成功搭建了一个基于 Spring Boot 3.x 的 Spring Cloud Alibaba 微服务项目。使用 Nacos 作为服务发现和配置中心，可以大大简化分布式架构中的服务管理和配置管理工作。

接下来，您可以根据需求扩展功能，例如实现服务间调用、负载均衡等，实现更复杂的微服务架构。希望本教程对您有所帮助！