Nacos 注册中心（服务注册）

以下是如何在 Spring Boot 微服务项目中集成 Nacos 注册中心（主要功能：动态服务发现、配置管理和服务管理平台）的详细步骤，包含依赖配置、代码实现和注意事项：

---

一、Nacos 的核心作用：微服务架构的“中枢神经系统

Nacos 是阿里巴巴开源的一款动态服务发现、配置管理和服务管理平台，专为云原生微服务架构设计，主要解决两大核心问题：

---

1. 服务注册与发现

• 功能：
  • 服务注册：微服务启动时，将自己的信息（IP、端口、健康状态）注册到 Nacos。
  • 服务发现：其他服务通过 Nacos 查询目标服务的可用实例列表，实现服务间通信。
• 类比：类似“电话簿”，动态维护服务地址，确保调用方总能找到健康的服务实例。

---

2. 统一配置管理

• 功能：
  • 集中存储配置：将各个微服务的配置（如数据库连接、开关参数）集中存储在 Nacos 服务器。
  • 动态更新：修改配置后无需重启服务，实时推送到所有相关应用。
• 类比：类似“遥控器”，统一管理所有服务的设置，灵活调整参数。

---

3.核心优势

• 动态性：实时感知服务状态变化（如实例上线/下线），保障调用可靠性。
• 易用性：提供可视化控制台，支持多环境（开发/测试/生产）隔离、配置版本回滚。
• 多生态集成：无缝兼容 Spring Cloud、Dubbo、Kubernetes 等主流框架。

---

一句话总结：
Nacos 是微服务的“管家”，既管理服务的注册与发现（让服务互相找到彼此），又统一管理所有配置（让系统灵活适应变化）。在一个服务调用另一个服务的时候通过这个nacos来知道是否可以使用成功。

二、环境准备

1. 安装 Nacos Server

• 下载地址：https://github.com/alibaba/nacos/releases
• 启动命令（单集群模式，单机模式下无需Mysql数据库表）：

  # 解压后进入 bin 目录
  sh startup.sh -m standalone  # Linux/Mac
  startup.cmd -m standalone   # Windows
  

• 访问控制台：http://localhost:8848/nacos（默认账号/密码：nacos/nacos）
• 打开效果
• 

2. 确认 Spring Cloud Alibaba 版本

选择兼容的版本组合（以当前主流版本为例）：

Spring Boot	Spring Cloud Alibaba	Spring Cloud
2.7.x	2021.0.5.0	2021.0.5
3.0.x	2022.0.0.0	2022.0.0

---

三、环境准备（数据库创建与否）

在使用 Nacos 时，是否需要创建数据库表取决于你的部署模式：

---

1. 单机模式（默认）

• 无需创建数据库表
  • Nacos 默认使用嵌入式数据库 Derby 存储配置和服务信息，自动管理数据。
  • 适用场景：开发测试、本地快速验证。
  • 缺点：Derby 不支持集群，数据无法持久化（重启后可能丢失）。

---

2. 集群模式（生产环境推荐）

• 必须创建数据库表
  • Nacos 集群需要依赖 MySQL 作为外部数据库（支持 5.7+ 或 8.0+），以实现数据持久化和多节点共享。
  • 操作步骤：
    1. 创建数据库：在 MySQL 中新建一个数据库（如 nacos_config）。
    2. 执行初始化 SQL：
       • 从 Nacos 的 GitHub Release 页面下载对应版本的 SQL 脚本（路径：https://github.com/alibaba/nacos/tree/master/distribution/conf）。
       • 在 MySQL 中执行该 SQL 文件，自动创建所需表（如 config_info, services 等）。
    3. 修改 Nacos 配置：
       • 编辑 conf/application.properties，配置 MySQL 连接：

         spring.datasource.platform=mysql
         db.num=1
         db.url.0=jdbc:mysql://localhost:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
         db.user=root
         db.password=your_password
         

---

3. 关键注意事项

• 版本匹配：确保 SQL 脚本与 Nacos 版本一致（如 Nacos 2.2.x 使用 nacos-mysql.sql）。
• 高可用保障：生产环境建议 MySQL 主从复制或使用云数据库（如阿里云 RDS）。
• 数据备份：定期备份 Nacos 数据库，防止配置和服务信息丢失。

---

• 单机模式：无需手动建表，直接使用默认 Derby。
• 集群模式：必须通过 MySQL 建表，并配置 Nacos 连接数据库。
• 生产环境必选集群模式，避免单点故障和数据丢失风险。

---

四、服务注册（项目配置）

1. 添加依赖

在 父工程 的 pom.xml 中声明版本管理：

<dependencyManagement>
    <dependencies>
        <!-- Spring Cloud Alibaba 依赖管理 -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2022.0.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

在 子模块 的 pom.xml 中添加具体依赖：

<!-- Nacos 服务注册与发现 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

<!-- Spring Boot Web 基础依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

2. 子模块 配置 application.yml 负责服务注册的相关信息

# 服务注册
server:
  port: 8081  # 服务端口

spring:
  application:
    name: user-service  # 服务名称（需唯一）
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848  # Nacos 服务器地址
        namespace: public            # 命名空间（默认public）
        group: DEFAULT_GROUP         # 分组（默认DEFAULT_GROUP）
        ephemeral: true              # 是否临时实例（默认true，宕机自动剔除）

3. 启用服务注册

在 Spring Boot 主类添加 @EnableDiscoveryClient 注解：

@SpringBootApplication
@EnableDiscoveryClient  // 开启服务注册与发现
public class UserServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

---

五、验证服务注册

在spring boot项目里面创建的这个服务如果成功可以在nacos里面看见。（服务注册）

1. 启动服务：运行微服务应用
2. 访问 Nacos 控制台：http://localhost:8848/nacos
   • 进入 服务管理 → 服务列表
   • 查看服务 user-service 的实例信息（IP + 端口）

---

六、服务调用（通过 OpenFeign）

OpenFeign简化开发

以下是使用 OpenFeign 调用已注册服务的完整步骤，包含依赖配置、接口定义和调用示例：

---

1. 添加依赖

在调用方模块的 pom.xml 中添加以下依赖：

<!-- OpenFeign -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

<!-- Spring Cloud LoadBalancer（如果使用 Spring Cloud 2020.x+ 版本，需手动添加） -->
<!-- 负载均衡 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

---

2. 配置application.yml 连接nacos

spring:
  application:
    name: order-service  # 调用方服务名称
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848  # Nacos 地址

3. 启用 Feign 客户端扫描

在调用方的主启动类添加注解：

@SpringBootApplication
@EnableFeignClients  // 启用 Feign 客户端扫描
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

---

4. 定义 Feign 客户端接口

假设被调用的服务名为 user-service，其 REST 接口为 GET /users/{id}，定义如下：

（1）创建 Feign 客户端接口

@FeignClient(name = "user-service")  // 指定目标服务名（与 Nacos 注册的服务名一致）
public interface UserClient {

    // 映射到 user-service 的接口（路径、方法、参数需完全一致）
    // 和在单体架构调用基本上一样
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
}

（2）参数匹配规则

• 路径参数：使用 @PathVariable 注解，必须明确指定参数名（如 @PathVariable("id")）。
• 请求体：使用 @RequestBody。
• 请求头：使用 @RequestHeader。
• 查询参数：使用 @RequestParam。

---

5. 注入并使用 Feign 客户端

在 Controller 或 Service 中直接注入 UserClient：

@RestController
@RequestMapping("/orders")
public class OrderController {

    @Autowired
    private UserClient userClient;

    @GetMapping("/{orderId}/user")
    public User getUserByOrderId(@PathVariable Long orderId) {
        // 调用 user-service 的接口
        return userClient.getUserById(123L);
    }
}

---

6. 配置熔断降级（可选）

（1）添加 Resilience4J 依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
</dependency>

（2）定义降级实现类

@Component
public class UserClientFallback implements UserClient {
    @Override
    public User getUserById(Long id) {
        return new User("fallback-user", "默认用户");  // 降级逻辑
    }
}

（3）启用降级配置

@FeignClient(
    name = "user-service", 
    fallback = UserClientFallback.class  // 指定降级类
)
public interface UserClient { 

    // 映射到 user-service 的接口（路径、方法、参数需完全一致）
    // 和在单体架构调用基本上一样
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
}

7. 连接池开启

（1）添加依赖

# okhttp连接池
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-okhttp</artifactId>
    <version>12.3</version>
</dependency>

（2）开始连接池

feign:
  httpclient:
    enabled: true

---

8. 自定义配置

超时配置（application.yml）

feign:
  client:
    config:
      user-service:  # 针对特定服务的配置
        connectTimeout: 3000  # 连接超时（ms）
        readTimeout: 5000     # 读取超时（ms）

1. 依赖：添加 spring-cloud-starter-openfeign。
2. 接口：通过 @FeignClient + 注解定义客户端接口。
3. 调用：注入接口直接调用，OpenFeign 自动处理服务发现和负载均衡。
4. 容错：通过 Resilience4J 或 Hystrix 实现熔断降级。
5. 验证：通过日志和 Nacos 控制台确保服务注册与调用正常。

---

七. 验证服务调用

1. 启动服务：确保 user-service 和 order-service 均已注册到 Nacos。
2. 调用接口：访问 http://localhost:order-service-port/orders/1/user。
3. 检查日志：
   • 调用方日志中应显示 OpenFeign 的请求记录。
   • 被调用方（user-service）日志中应收到请求。

---

耦合度低

耦合度高

---