1
2
3

方案 A：Nacos 单组件（注册 + 配置一站式）
方案 B：Consul 单组件（HashiCorp 生态，多语言友好）
方案 C：Zookeeper（注册） + Apollo（配置）双组件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

┌──────────────────┐          ┌──────────────────┐
│ Service Provider │          │  Nacos Server    │
│ (订单服务实例)    │  注册   │  (注册表 + 推送) │
│                  ├─────────►│                  │
│  - IP: 10.1.0.5  │  心跳   │   /services      │
│  - port: 8080    ├─────────►│   /instances     │
│  - weight: 1.0   │          │   /push          │
│  - metadata: {}  │          │                  │
└──────────────────┘          └─────────┬────────┘
                                        │
                              UDP 推送 / Long-Polling
                                        ▼
                              ┌──────────────────┐
                              │ Service Consumer │
                              │ (用户服务实例)    │
                              │                  │
                              │  本地缓存:        │
                              │   order-service  │
                              │    - 10.1.0.5    │
                              │    - 10.1.0.6    │
                              └──────────────────┘

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 下载 release 包（以 2.3.0 为例）
wget https://github.com/alibaba/nacos/releases/download/2.3.0/nacos-server-2.3.0.tar.gz
tar -xzf nacos-server-2.3.0.tar.gz
cd nacos/bin

# Linux/Mac 启动（单机模式）
sh startup.sh -m standalone

# Windows
startup.cmd -m standalone

# 启动后访问控制台
# http://localhost:8848/nacos
# 默认账号 nacos / nacos（生产环境必改）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

<properties>
    <spring-boot.version>3.2.0</spring-boot.version>
    <spring-cloud.version>2022.0.4</spring-cloud.version>
    <spring-cloud-alibaba.version>2022.0.0.0</spring-cloud-alibaba.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>${spring-cloud-alibaba.version}</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>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>
    <!-- 负载均衡（替代废弃的 Ribbon） -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-loadbalancer</artifactId>
    </dependency>
</dependencies>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

spring:
  application:
    name: order-service
  cloud:
    nacos:
      discovery:
        server-addr: 10.1.0.10:8848,10.1.0.11:8848,10.1.0.12:8848
        namespace: prod-order              # 命名空间隔离
        group: ORDER_GROUP                  # 分组
        cluster-name: HZ_CELL1              # 集群名（异地多活分单元用）
        username: order-app
        password: ${NACOS_PASSWORD}         # 走环境变量，禁止明文
        metadata:                            # 自定义元数据（灰度发布、版本路由用）
          version: 1.2.3
          region: hangzhou

1
2
3
4
5
6

@SpringBootApplication
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

@FeignClient(name = "user-service")
public interface UserFeignClient {
    @GetMapping("/api/users/{id}")
    UserDto getUser(@PathVariable("id") Long id);
}

@RestController
@RequiredArgsConstructor
public class OrderController {
    private final UserFeignClient userFeign;

    @GetMapping("/api/orders/{id}/with-user")
    public OrderDetailDto getOrderWithUser(@PathVariable Long id) {
        // 直接用服务名调用，LoadBalancer 自动从 Nacos 拉实例列表 + 负载均衡
        UserDto user = userFeign.getUser(orderRepo.findById(id).getUserId());
        return OrderDetailDto.of(orderRepo.findById(id), user);
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>3.2.10</version>
</dependency>
<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-registry-nacos</artifactId>
    <version>3.2.10</version>
</dependency>

1
2
3
4
5
6
7
8
9

dubbo:
  application:
    name: order-service
    qos-enable: false
  registry:
    address: nacos://10.1.0.10:8848?namespace=prod-order&username=order-app
  protocol:
    name: tri                              # Triple 协议（Dubbo 3 推荐）
    port: 20880

1

spring.cloud.nacos.discovery.ephemeral: false   # 改为持久化实例

1
2

# 通过 Open API 把某个服务切换为 CP 模式
curl -X PUT 'http://nacos:8848/nacos/v1/ns/service?serviceName=order-service&protectThreshold=0.5'

1
2
3
4
5
6
7
8
9

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
<!-- Spring Cloud 2022 之后配置由 spring.config.import 引入，bootstrap.yml 已废弃 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

spring:
  application:
    name: order-service
  profiles:
    active: prod
  config:
    import:
      - optional:nacos:order-service.yml?refreshEnabled=true
      - optional:nacos:order-service-${spring.profiles.active}.yml?refreshEnabled=true
      - optional:nacos:common-config.yml?refreshEnabled=true&group=COMMON_GROUP
  cloud:
    nacos:
      config:
        server-addr: 10.1.0.10:8848,10.1.0.11:8848,10.1.0.12:8848
        namespace: prod-order
        username: order-app
        password: ${NACOS_PASSWORD}
        file-extension: yml

1
2
3
4
5
6
7
8

namespace-id          namespace-name        含义
─────────────────────────────────────────────────
dev                   开发环境              dev、共享资源都在这
test                  测试环境              测试 DB / Redis
staging               预发环境              生产镜像 + 真实数据脱敏
prod-order            生产-订单业务线        订单业务线独立
prod-payment          生产-支付业务线        支付业务线独立
prod-search           生产-搜索业务线        搜索业务线独立

1
2
3
4
5
6
7

group-name            含义
────────────────────────────────────────────
DEFAULT_GROUP         默认分组（不指定时）
ORDER_GROUP           订单业务专属配置
PAYMENT_GROUP         支付业务专属配置
COMMON_GROUP          所有服务共享的基础配置（Redis 集群地址等）
GRAY_GROUP            灰度发布配置（小流量验证用）

1
2
3
4
5
6
7
8
9

{应用名}.{后缀}                          # 应用专属
{应用名}-{profile}.{后缀}                # 按 profile 区分
{共享配置名}.{后缀}                       # 跨应用共享配置

例子：
- order-service.yml                       # 订单服务通用配置
- order-service-prod.yml                  # 订单服务生产环境配置
- common-redis.yml                        # 共享 Redis 配置（COMMON_GROUP）
- order-service-gray.yml                  # 订单服务灰度配置（GRAY_GROUP）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

@Component
@RefreshScope
public class FeatureToggleConfig {
    @Value("${feature.new-order-flow:false}")
    private boolean newOrderFlowEnabled;

    public boolean isNewOrderFlowEnabled() {
        return newOrderFlowEnabled;
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

// 配置 POJO
@Component
@ConfigurationProperties(prefix = "order")
@Data
public class OrderProperties {
    private int maxQuantityPerOrder = 100;
    private int timeoutSeconds = 30;
    private List<String> blockedRegions = new ArrayList<>();
    private RetryConfig retry = new RetryConfig();

    @Data
    public static class RetryConfig {
        private int maxAttempts = 3;
        private long backoffMs = 100;
    }
}

// Service 直接注入，无需 @RefreshScope
@Service
@RequiredArgsConstructor
public class OrderService {
    private final OrderProperties props;

    public Order createOrder(OrderRequest req) {
        if (req.getQuantity() > props.getMaxQuantityPerOrder()) {
            throw new BizException("超过单笔订单上限");
        }
        // ...
    }
}

// 显式监听刷新事件（需要做一些副作用时）
@Component
@RequiredArgsConstructor
public class OrderConfigRefreshListener {
    private final ConnectionPoolManager poolMgr;
    private final OrderProperties props;

    @EventListener
    public void onRefresh(RefreshEvent event) {
        // 配置变化后，根据需要做副作用（如重建连接池）
        poolMgr.rebuildIfNeeded(props.getRetry().getMaxAttempts());
    }
}

1
2
3
4

# cluster.conf 示例（3 节点）
nacos-1.nacos-headless.default.svc.cluster.local:8848
nacos-2.nacos-headless.default.svc.cluster.local:8848
nacos-3.nacos-headless.default.svc.cluster.local:8848

1
2
3
4
5
6
7

spring:
  cloud:
    loadbalancer:
      cache:
        ttl: 10s                # 默认 35s，按业务可调
      nacos:
        enabled: true            # 启用 Nacos 专用负载均衡（基于 weight + cluster）

1
2
3
4
5
6

spring:
  cloud:
    nacos:
      discovery:
        watch:
          enabled: false         # 关闭客户端 watch（如果不需要实时性）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# conf/application.properties
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://10.1.0.50:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false&serverTimezone=Asia/Shanghai
db.user.0=nacos_user
db.password.0=${NACOS_DB_PASSWORD}

# 连接池调优（生产环境）
db.pool.config.connectionTimeout=30000
db.pool.config.validationTimeout=10000
db.pool.config.maximumPoolSize=20
db.pool.config.minimumIdle=10

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# conf/application.properties
# 1. 启用鉴权
nacos.core.auth.enabled=true
nacos.core.auth.system.type=nacos
nacos.core.auth.plugin.nacos.token.secret.key=${NACOS_TOKEN_SECRET}    # 32+ 字符随机
nacos.core.auth.plugin.nacos.token.expire.seconds=18000

# 2. 集群内部通信认证
nacos.core.auth.server.identity.key=server-identity-key
nacos.core.auth.server.identity.value=${NACOS_SERVER_IDENTITY}

# 3. 关闭非授权请求
nacos.core.auth.enable.userAgentAuthWhite=false

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

              ┌──────────────────────────────────────┐
              │           Nacos 集群（5 节点）         │
              │  HZ-1   HZ-2   SH-1   SH-2   BJ-1    │
              │  └─Raft 协议 + Distro 协议─┘          │
              └──────────────────────────────────────┘
                       │                │
                ┌──────┴───────┐ ┌──────┴────────┐
                │  杭州机房     │ │  上海机房      │
                │  (UnitA)     │ │  (UnitB)      │
                └──────────────┘ └───────────────┘

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

┌──────────────────────┐        ┌──────────────────────┐
│  杭州机房 Nacos 集群  │        │  上海机房 Nacos 集群   │
│  (3 节点)            │        │  (3 节点)            │
│  namespace:          │        │  namespace:          │
│   - hz-prod-order    │        │   - sh-prod-order    │
│   - hz-prod-payment  │        │   - sh-prod-payment  │
└──────────┬───────────┘        └───────────┬──────────┘
           │                                │
       本机房服务                       本机房服务
       注册 / 发现                      注册 / 发现
           │                                │
           └────────────┬───────────────────┘
                        │
                跨机房调用极少
                  (单元化设计)

1
2
3
4
5
6
7

namespace-id          含义                       所在机房
─────────────────────────────────────────────────────────
hz-prod-order         杭州单元-订单业务           HZ 机房 Nacos
hz-prod-payment       杭州单元-支付业务           HZ 机房 Nacos
sh-prod-order         上海单元-订单业务           SH 机房 Nacos
sh-prod-payment       上海单元-支付业务           SH 机房 Nacos
global-config         全局共享配置（如 OSS 域名）  双机房 Nacos 同步

1
2
3
4
5
6
7
8
9

spring:
  cloud:
    nacos:
      discovery:
        server-addr: ${NACOS_LOCAL_ADDR}                # 由部署时注入本机房地址
        namespace: ${UNIT_PREFIX}-prod-order            # UNIT_PREFIX 由 K8s ConfigMap 注入
      config:
        server-addr: ${NACOS_LOCAL_ADDR}
        namespace: ${UNIT_PREFIX}-prod-order

1
2
3
4
5
6
7
8

apiVersion: v1
kind: ConfigMap
metadata:
  name: env-config
  namespace: prod
data:
  NACOS_LOCAL_ADDR: nacos-hz.svc.cluster.local:8848
  UNIT_PREFIX: hz

1
2
3

data:
  NACOS_LOCAL_ADDR: nacos-sh.svc.cluster.local:8848
  UNIT_PREFIX: sh

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

用户请求
  │
  ▼
公网 LB（DNS / 智能调度）→ 决定打到哪个机房
  │
  ▼
LVS（四层转发）→ 把流量打到本机房 Nginx
  │
  ▼
Nginx（七层路由）→ 按 URL 转到应用网关
  │
  ▼
Spring Cloud Gateway（应用网关）→ 从 Nacos 拉服务列表 + 路由
  │
  ▼
微服务（OrderService / UserService...）

1
2
3
4
5
6
7
8

正常态：
  - 用户 A → HZ 机房 → hz-prod-order namespace → HZ 订单服务
  - 用户 B → SH 机房 → sh-prod-order namespace → SH 订单服务

HZ 机房故障：
  - 公网 LB（第 1 篇讲）感知 HZ 不可用，把用户 A 的流量切到 SH
  - 用户 A → SH 机房 → sh-prod-order namespace → SH 订单服务
  - Nacos 不需要做任何切换——本来就独立

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# global-config/unit-routing.yml
units:
  hz:
    enabled: true
    weight: 50
    backup: sh
  sh:
    enabled: true
    weight: 50
    backup: hz

  # 故障时把 hz 设为 false，所有流量去 sh