Nacos 配置中心深度解析

cheniy2025/9/17大约 3 分钟

Nacos 配置中心深度解析

前置知识

在开始本教程之前，请确保已经：

完成 Nacos 基础入门
了解 Spring Cloud Config
掌握 YAML 配置格式

配置中心概述

核心特性

mindmap
  root((配置中心))
    配置管理
      配置创建
      配置修改
      配置删除
      版本管理
    配置推送
      实时推送
      批量更新
      灰度发布
    权限控制
      用户认证
      命名空间
      配置加密

配置管理基础

1. 添加依赖

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

2. 基础配置

在 bootstrap.yml 中配置：

spring:
  application:
    name: nacos-config-demo
  cloud:
    nacos:
      config:
        # 配置中心地址
        server-addr: localhost:8848
        # 配置文件格式
        file-extension: yaml
        # 配置组
        group: DEFAULT_GROUP
        # 命名空间
        namespace: public
        # 共享配置
        shared-configs:
          - data-id: common.yaml
            group: DEFAULT_GROUP
            refresh: true

3. 配置的使用

package com.example.nacos;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RefreshScope
public class ConfigController {
    
    @Value("${config.name:default}")
    private String name;
    
    @GetMapping("/config/name")
    public String getName() {
        return name;
    }
}

动态配置更新

配置监听

package com.example.nacos;

import com.alibaba.nacos.api.config.annotation.NacosConfigListener;
import org.springframework.stereotype.Component;

@Component
public class ConfigChangeListener {
    
    @NacosConfigListener(dataId = "nacos-config-demo.yaml", groupId = "DEFAULT_GROUP")
    public void onConfigChange(String newContent) {
        // 配置变更处理逻辑
        System.out.println("配置已更新: " + newContent);
    }
}

配置加密解密

加密配置

package com.example.nacos;

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

@Configuration
@RefreshScope
public class EncryptConfig {
    
    @Value("${encrypted.property}")
    private String encryptedProperty;
    
    public String getDecryptedValue() {
        // 解密逻辑
        return decrypt(encryptedProperty);
    }
    
    private String decrypt(String value) {
        // 实现解密算法
        return value;
    }
}

多环境配置

环境配置示例

# 开发环境配置
spring:
  cloud:
    nacos:
      config:
        # 开发环境命名空间
        namespace: dev
        # 环境特定配置
        extension-configs:
          - data-id: database-dev.yaml
            group: DEV_GROUP
            refresh: true

高级特性

1. 命名空间管理

package com.example.nacos;

import com.alibaba.nacos.api.config.ConfigService;
import com.alibaba.nacos.api.exception.NacosException;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class NamespaceService {
    
    @Autowired
    private ConfigService configService;
    
    public void switchNamespace(String namespace) {
        // 切换命名空间逻辑
        System.out.println("切换到命名空间: " + namespace);
    }
}

2. 配置导入导出

package com.example.nacos;

import com.alibaba.nacos.api.config.ConfigService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class ConfigExportService {
    
    @Autowired
    private ConfigService configService;
    
    public String exportConfig(String dataId, String group) {
        try {
            return configService.getConfig(dataId, group, 5000);
        } catch (Exception e) {
            return "配置导出失败";
        }
    }
}

实战示例

配置中心实践

package com.example.nacos;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.context.annotation.Configuration;

@Data
@RefreshScope
@Configuration
@ConfigurationProperties(prefix = "app")
public class AppConfig {
    private String name;
    private String version;
    private DatabaseConfig database;
    
    @Data
    public static class DatabaseConfig {
        private String url;
        private String username;
        // 密码字段使用加密存储
        private String encryptedPassword;
    }
}