spring boot 项目通过 spring cloud config 实现统一配置管理，核心是将 application.yml 拆分并集中存于 git，config server 提供配置服务，client 启动拉取、运行时动态刷新，无需重启，环境隔离清晰，运维开发协作高效。
Spring Boot 项目接入 Spring Cloud Config 实现统一配置管理，核心是把各服务的 application.yml 拆出来集中存到 Git，再通过独立的 Config Server 对外提供配置服务，Client 启动时自动拉取、运行时按需刷新——整个过程不重启服务，环境隔离清晰，运维和开发协作更高效。
Git 仓库规范存放配置文件
这是整个方案的基础。所有配置不再放在服务本地，而是提交到远程 Git（如 Gitee、GitHub 或私有 GitLab）：
-
命名必须严格遵循：
{service-name}-{profile}.yml，例如order-service-prod.yml、user-service-dev.yml -
目录结构建议分层：按服务名建文件夹（如
order-service/），再按环境建子目录（dev/、prod/），便于权限控制与 CI/CD 集成 -
公共配置复用：在根目录放一个
application.yml，里面写日志格式、通用中间件地址等，所有服务会自动合并该配置 -
敏感信息加密存储：密码类字段用
{cipher}xxx格式，Server 端配置encrypt.key后可自动解密返回明文
搭建 Config Server 服务端
单独起一个 Spring Boot 应用作为配置“总出口”：
- 引入依赖：
spring-cloud-config-server和spring-boot-starter-actuator（用于后续刷新） - 启动类加注解：
@EnableConfigServer -
application.yml中指定 Git 地址与路径：
spring:
cloud:
config:
server:
git:
uri: https://gitee.com/yourname/config-repo.git
search-paths: "{application}"
启动后访问 http://localhost:8888/order-service/prod 能看到解析后的 YAML 内容，说明 Server 已连通仓库。
微服务接入 Config Client
每个微服务要变成“配置消费者”，关键在初始化阶段就连接 Server：
- 添加依赖：
spring-cloud-starter-config（注意不是spring-cloud-config-server） - 新建
bootstrap.yml（不是application.yml），优先级更高，确保配置早于 Spring Context 加载：
spring:
application:
name: order-service
cloud:
config:
uri: http://localhost:8888
profile: prod
label: master
- 需要动态刷新配置时，在对应 Bean 上加
@RefreshScope注解 - 配合 Spring Cloud Bus（如 Kafka 或 RabbitMQ）+
/actuator/refresh接口，可实现全量广播刷新
验证与常见问题处理
接入后可通过以下方式确认是否生效：
- 启动服务时查看日志，出现
Fetched config from server表示成功拉取 - 访问
/actuator/env查看当前生效的配置源，应包含configService:https://... - 修改 Git 中配置并提交后，调用
POST /actuator/refresh，检查 Bean 属性是否更新 - 若刷新失败，检查
bootstrap.yml是否存在、Server 地址是否可达、@RefreshScope是否加在正确类上
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
