实用指南：《架构师手记：SpringCloud整合Nacos实战·一》

《架构师手记：SpringCloud整合Nacos实战·一》

第一章：SpringCloud与Nacos的初识之旅

引言

在微服务架构的浪潮中，服务发现和配置管理成为了每个架构师必须面对的挑战。今天，我们将开启一段SpringCloud与Nacos的探索之旅，揭开分布式系统架构的神秘面纱。

什么是Nacos？

Nacos（Naming and Configuration Service）是阿里巴巴开源的动态服务发现、配置管理和服务管理平台。它致力于帮助您发现、配置和管理微服务。

在这里插入图片描述

Nacos的核心功能

服务发现与服务健康监测
动态配置管理
动态DNS服务
服务及其元数据管理

环境准备

1. 技术栈要求

JDK 17+
Spring Boot 3.2.0+
Spring Cloud 2023.0.0+
Spring Cloud Alibaba 2023.0.1.0+

2. 项目初始化

<!-- pom.xml 基础依赖配置 -->
  <properties>
  <spring-boot.version>3.2.5</spring-boot.version>
  <spring-cloud.version>2023.0.3</spring-cloud.version>
  <spring-cloud-alibaba.version>2023.0.2.0</spring-cloud-alibaba.version>
  </properties>
  <dependencies>
    <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <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服务器部署

win本地快速部署

从官网下载Nacos解压后，cmd进入Nacos文件夹的bin目录(点此下载Nacos)
在这里插入图片描述
在cmd页面输入以下命令，即可启动Nacos，如下图所示。

# 单机模式部署
startup.cmd -m standalone

在这里插入图片描述

访问控制台

打开浏览器访问：http://localhost:8848/nacos，即可进入Nacos页面

用户名：nacos
密码：nacos

第一个SpringCloud服务

创建启动类

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

配置文件 bootstrap.yml

spring:
application:
name: user-service
cloud:
nacos:
discovery:
server-addr: localhost:8848
namespace: public
group: DEFAULT_GROUP
enabled: true
register-enabled: true
# 添加这些配置确保注册
ip: localhost # 本机IP
port: 8002 # 服务端口
config:
server-addr: localhost:8848
file-extension: yaml
namespace: public
group: DEFAULT_GROUP
enabled: true
refresh-enabled: true

实战：服务注册与发现

服务提供者

启动我们的JavaSmsCloudUserProviderApplication.class文件，即可在服务列表看见我们的服务了
在这里插入图片描述

核心原理剖析

Nacos服务注册流程

启动注册：应用启动时向Nacos Server发送注册请求
心跳检测：定期发送心跳包维持服务活性
服务发现：消费者从Nacos Server获取服务实例列表

Nacos配置管理流程

配置获取：应用启动时从Nacos Server拉取配置
配置监听：监听配置变更事件
动态刷新：配置变更时自动刷新应用配置

常见问题排查

1. 服务无法注册

症状：服务启动成功，但在Nacos控制台看不到服务实例

解决方案：

# 检查配置是否正确
spring:
cloud:
nacos:
discovery:
enabled: true # 确保启用服务发现
register-enabled: true # 确保启用注册功能

2. 配置无法加载

症状：@Value注解获取不到配置值