分布式淘客系统的配置中心设计：Nacos在多环境配置管理的应用

大家好，我是微赚淘客系统3.0 的研发者省赚客！

随着微赚淘客系统3.0业务模块拆分为用户服务、佣金服务、商品同步服务等多个微服务，传统配置文件方式已无法满足动态调整、灰度发布与多环境隔离的需求。为此，我们全面引入 Nacos 作为统一配置中心，实现开发（dev）、测试（test）、预发（staging）、生产（prod）四套环境的配置隔离与热更新能力。

一、Nacos 配置模型设计

在 Nacos 控制台中，按以下规则组织配置：

Data ID ：{application}-{profile}.yaml
例如：rebate-user-service-prod.yaml
Group ：REBATE_GROUP
Namespace ：为每个环境创建独立命名空间（如 prod-ns、test-ns），通过 ID 隔离

此结构确保不同环境配置互不干扰，且支持服务粒度覆盖。

二、Spring Boot 集成 Nacos Config

在 juwatech.cn.rebate 模块的 pom.xml 中引入依赖：

xml 复制代码

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>2022.0.0.0</version>
</dependency>

bootstrap.yml 配置连接信息（注意：必须使用 bootstrap 而非 application）：

yaml 复制代码

spring:
  application:
    name: rebate-user-service
  cloud:
    nacos:
      config:
        server-addr: nacos.juwatech.cn:8848
        namespace: ${NACOS_NAMESPACE:public}  # 通过环境变量注入
        group: REBATE_GROUP
        file-extension: yaml
        timeout: 5000

启动时，应用会自动加载 ${spring.application.name}-${spring.profiles.active}.${file-extension} 对应的配置。

三、多环境配置示例

以数据库连接为例，在 Nacos 中分别维护：

prod 命名空间 → Data ID: rebate-user-service-prod.yaml

yaml 复制代码

spring:
  datasource:
    url: jdbc:mysql://db-prod.juwatech.cn:3306/rebate_user?useSSL=false
    username: prod_user
    password: Prod@2026!

test 命名空间 → Data ID: rebate-user-service-test.yaml

yaml 复制代码

spring:
  datasource:
    url: jdbc:mysql://db-test.juwatech.cn:3306/rebate_user_test
    username: test_user
    password: TestPass123

应用启动时通过 -Dspring.profiles.active=prod 指定环境，自动拉取对应配置。

四、配置热更新与监听

对于运行时可变参数（如返利比例、限流阈值），使用 @RefreshScope 实现动态刷新：

java 复制代码

package juwatech.cn.rebate.config;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Component;

@Component
@RefreshScope
public class CommissionConfig {

    @Value("${commission.rate.default:0.1}")
    private double defaultRate;

    @Value("${commission.max.amount:500}")
    private BigDecimal maxAmount;

    public double getDefaultRate() {
        return defaultRate;
    }

    public BigDecimal getMaxAmount() {
        return maxAmount;
    }
}

当 Nacos 中配置变更并发布后，CommissionConfig 实例将被重建，新值立即生效，无需重启服务。

若需主动监听变更事件，可实现 Listener：

java 复制代码

package juwatech.cn.rebate.listener;

import com.alibaba.nacos.api.config.listener.Listener;
import org.springframework.stereotype.Component;

import javax.annotation.PostConstruct;
import java.util.concurrent.Executor;

@Component
public class CustomConfigListener {

    @PostConstruct
    public void registerListener() {
        try {
            String dataId = "rebate-business-rules.yaml";
            String group = "REBATE_GROUP";
            ConfigService configService = NacosFactory.createConfigService("nacos.juwatech.cn:8848");
            
            configService.addListener(dataId, group, new Listener() {
                @Override
                public void receiveConfigInfo(String configInfo) {
                    // 解析新配置并更新本地缓存
                    BusinessRuleCache.update(configInfo);
                }

                @Override
                public Executor getExecutor() {
                    return null; // 使用默认线程池
                }
            });
        } catch (Exception e) {
            throw new RuntimeException("注册Nacos监听失败", e);
        }
    }
}

五、Kubernetes 环境变量注入

在 K8s Deployment 中通过环境变量指定命名空间，实现部署即适配环境：

yaml 复制代码

apiVersion: apps/v1
kind: Deployment
metadata:
  name: rebate-user-service
spec:
  template:
    spec:
      containers:
        - name: app
          image: harbor.juwatech.cn/rebate/rebate-user-service:latest
          env:
            - name: NACOS_NAMESPACE
              valueFrom:
                configMapKeyRef:
                  name: rebate-env-config
                  key: nacos.namespace
            - name: SPRING_PROFILES_ACTIVE
              value: "prod"

其中 rebate-env-config ConfigMap 内容为：

yaml 复制代码

apiVersion: v1
kind: ConfigMap
metadata:
  name: rebate-env-config
data:
  nacos.namespace: "a1b2c3d4-5678-90ef-ghij-klmnopqrstuv"  # prod 命名空间ID

六、配置安全与权限控制

Nacos 开启鉴权后，所有客户端需配置用户名密码：

yaml 复制代码

spring:
  cloud:
    nacos:
      config:
        username: nacos_rebate
        password: SecurePass!2026

同时，通过 Nacos RBAC 功能限制开发人员仅能编辑 test 命名空间，生产配置由运维团队审批后发布。

本文著作权归微赚淘客系统3.0 研发团队，转载请注明出处！