Nacos 注册中心（服务注册）

原创已于 2025-04-09 21:55:03 修改 · 3.1k 阅读

57 ·

CC 4.0 BY-SA版权

文章标签：

#spring cloud #nacos #OpenFeign #微服务 #服务注册 #服务调用 #nacos下载

于 2025-04-08 20:56:09 首次发布

微服务专栏收录该内容

10 篇文章

订阅专栏

以下是如何在 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里面看见。（服务注册）

启动服务：运行微服务应用
访问 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）

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

七. 验证服务调用

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

耦合度低
在这里插入图片描述
耦合度高

Nacos 注册中心（服务注册）

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

1. 服务注册与发现

2. 统一配置管理

3.核心优势

二、环境准备

1. 安装 Nacos Server

2. 确认 Spring Cloud Alibaba 版本

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

1. 单机模式（默认）

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

3. 关键注意事项

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

1. 添加依赖

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

3. 启用服务注册

五、验证服务注册

六、服务调用（通过 OpenFeign）

1. 添加依赖

2. 配置application.yml 连接nacos

3. 启用 Feign 客户端扫描

4. 定义 Feign 客户端接口

（1）创建 Feign 客户端接口

（2）参数匹配规则

5. 注入并使用 Feign 客户端

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

（1）添加 Resilience4J 依赖

（2）定义降级实现类

（3）启用降级配置

7. 连接池开启

（1）添加依赖

（2）开始连接池

8. 自定义配置

超时配置（application.yml）

七. 验证服务调用

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

2. 配置`application.yml` 连接nacos

超时配置（`application.yml`）