Spring Boot 3.x使用用户托管身份无法访问Azure应用配置求助

问题概述 #

使用Spring Boot 3.1.0结合com.azure.spring:azure-spring-cloud-appconfiguration-config-web:2.11.0依赖，通过用户托管身份连接Azure应用配置时，出现以下错误：

com.microsoft.aad.msal4j.MsalAzureSDKException: java.util.concurrent.ExecutionException: com.azure.identity.CredentialUnavailableException: ManagedIdentityCredential authentication unavailable. Connection to IMDS endpoint cannot be established, Network is unreachable: no further information.

已配置有效环境变量AZURE_CLIENT_ID、AZURE_CLIENT_SECRET、AZURE_TENANT_ID，且相同凭证信息在普通Java项目中使用DefaultAzureCredential可正常连接Azure应用配置，但Spring Boot环境下无法运行。

核心原因分析 #

1. 凭证加载逻辑差异 #

普通Java代码中，DefaultAzureCredential会按优先级依次尝试多种凭证类型：环境变量（服务主体）> 托管身份 > Azure CLI等。当环境变量存在有效服务主体信息时，会直接使用该凭证，不会触发IMDS端点调用。

但在Spring Boot配置中，明确指定了managed-identity.client-id，这会强制Azure Spring Cloud App Config SDK仅尝试用户托管身份认证，忽略环境变量中的服务主体凭证。若运行环境（如本地开发环境）未配置托管身份，就会出现IMDS端点连接失败的错误。

2. 依赖版本不兼容 #

com.azure.spring:azure-spring-cloud-appconfiguration-config-web:2.11.0是为Spring Boot 2.x设计的版本，与Spring Boot 3.x存在兼容性差异，包括自动配置逻辑、凭证加载机制的不一致，这会导致托管身份认证流程异常。

解决方案 #

方案1：移除强制托管身份配置，复用DefaultAzureCredential逻辑 #

修改bootstrap.yml，删除managed-identity节点，让SDK自动按优先级加载凭证（优先使用环境变量中的服务主体）：

spring:
  application:
    name: app-service
    version: 0.0.1
  cloud:
    azure:
      appconfiguration:
        enabled: ${APP_CONFIGURATION_ENABLED} # true
        stores:
          - endpoint: ${AZURE_END_POINT} # 有效端点

方案2：指定凭证类型，适配不同运行环境 #

若需保留托管身份配置（如Azure托管环境运行），可通过spring.cloud.azure.credential.type指定凭证类型，本地开发时强制使用环境变量凭证：

spring:
  application:
    name: app-service
    version: 0.0.1
  cloud:
    azure:
      credential:
        type: ENVIRONMENT
      appconfiguration:
        enabled: ${APP_CONFIGURATION_ENABLED}
        managed-identity:
          client-id: ${AZURE_CLIENT_ID}
        stores:
          - endpoint: ${AZURE_END_POINT}

方案3：升级依赖到适配Spring Boot 3.x的版本 #

将Azure Spring Cloud App Config依赖升级为兼容Spring Boot 3.x的版本（如4.11.0，具体版本可根据官方版本矩阵调整）：

implementation ('com.azure.spring:azure-spring-cloud-appconfiguration-config-web:4.11.0')

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