如何将Azure AppConfiguration与Spring Boot 2.5.x及更高版本集成

适配Spring Boot 2.5.4的Azure AppConfiguration配置方案 #

核心问题根源

你之前使用的2.0.0版本com.azure.spring:azure-spring-cloud-appconfiguration-config与Spring Boot 2.5.x存在适配缺陷，且非web场景依赖无法兼容带Web、WebSocket等启动器的项目。 #

修复步骤

• 第一步：替换Maven依赖
  将原有配置中心依赖替换为web场景专用适配依赖，升级到2.1.0版本，该版本已完成Spring Boot 2.5.x兼容：

  <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>azure-spring-cloud-appconfiguration-config-web</artifactId>
      <version>2.1.0</version>
  </dependency>
  

• 第二步：使用bootstrap.properties存储配置
  目前2.x版本Azure AppConfiguration客户端仍强制要求配置项放在bootstrap.properties（或bootstrap.yml）中才能在启动上下文优先阶段加载，即使Spring Boot 2.4+已将bootstrap标记为过时，仍需保留该配置文件，无需开启spring.config.use-legacy-processing参数。
  bootstrap.properties配置示例：

  # 控制Azure配置中心开关，关闭时会完全读取本地application配置
  spring.cloud.azure.appconfiguration.enabled=true
  
  # Azure AppConfiguration连接字符串，替换为自身资源对应值
  spring.cloud.azure.appconfiguration.stores[0].connection-string= Endpoint=https://你自己的配置中心地址.azconfig.io;Id=你的资源ID;Secret=你的访问密钥
  
  # 配置拉取规则，按前缀和标签过滤需要拉取的配置
  spring.cloud.azure.appconfiguration.stores[0].selects[0].key-filter = /mysampleservice/
  spring.cloud.azure.appconfiguration.stores[0].selects[0].label-filter = develop
  spring.cloud.azure.appconfiguration.stores[0].selects[1].key-filter = /公共配置前缀/
  spring.cloud.azure.appconfiguration.stores[0].selects[1].label-filter = develop
  

• 第三步：配置校验
  确认Azure AppConfiguration控制台的配置项满足以下要求：
  • 键名匹配你设置的key-filter前缀规则，比如/mysampleservice/message
  • 标签和你在配置中设置的label-filter值完全匹配，注意大小写敏感

额外排查点

• 无法连接时先检查本地网络是否能访问Azure AppConfiguration的公网端点，确认无防火墙拦截
• 检查连接字符串中的密钥未过期，对应访问身份有配置读取权限
• 启动时添加--debug参数启动，查看启动日志中Azure AppConfiguration相关的加载、报错信息，可快速定位是网络问题、权限问题还是配置匹配问题

内容的提问来源于stack exchange，提问作者Ki_Netic