Spring Boot部署至Azure Service Fabric：应用参数无法解析为环境变量

我太懂你这种踩坑的感受了——明明把配置都按思路写了，结果Spring Boot启动时拿到的全是占位符字符串，直接导致Key Vault初始化失败抛错。咱们先把问题根源找出来，再一步步修正配置：

问题根源分析 #

你当前的配置逻辑出现了参数引用语法错误：

1. 在ServiceManifest.xml中，你给环境变量赋值用了[AZURE_TENANT_ID]这种格式，但这个名称并不是ApplicationManifest.xml中定义的应用参数（你的应用参数名是AzureTenantId，驼峰命名），所以Service Fabric无法识别这个占位符，直接原封不动传给了Spring Boot。
2. 如果你想通过ConfigPackage中转参数，环境变量的引用语法也不对，需要用Service Fabric专门的Config参数引用格式，而非方括号。

解决方案：两种可行的配置方式 #

方式一：直接映射应用参数到环境变量（推荐，更简洁） #

跳过ConfigPackage的中转，直接在ServiceManifest.xml中引用ApplicationManifest定义的参数，配置更直观：

修正后的ServiceManifest.xml（CodePackage部分）

<CodePackage Name="code" Version="1.0.0">
  <EntryPoint>
    <ExeHost>
      <Program>jre/bin/java</Program>
      <Arguments>-jar service-fab-deployment-0.0.1-SNAPSHOT.jar</Arguments>
      <WorkingFolder>CodePackage</WorkingFolder>
      <ConsoleRedirection FileRetentionCount="5" FileMaxSizeInKb="2048" />
    </ExeHost>
  </EntryPoint>
  <EnvironmentVariables>
    <!-- 直接引用ApplicationManifest中定义的参数，注意参数名要完全匹配 -->
    <EnvironmentVariable Name="AZURE_TENANT_ID" Value="[AzureTenantId]" />
    <EnvironmentVariable Name="AZURE_CLIENT_ID" Value="[AzureClientId]" />
    <EnvironmentVariable Name="AZURE_CLIENT_SECRET" Value="[AzureClientSecret]" />
    <EnvironmentVariable Name="AZURE_KEYVAULT_ENDPOINT" Value="[AzureKeyVaultUri]" />
    <EnvironmentVariable Name="SERVER_PORT" Value="[ServerPort]" />
  </EnvironmentVariables>
</CodePackage>
<ConfigPackage Name="Config" Version="1.0.0" />

ApplicationManifest.xml保持现有配置即可

不需要修改ConfigOverrides部分，直接保留原有的参数定义：

<Parameters>
  <Parameter Name="DataEnciphermentCertThumbprint" DefaultValue="" />
  <Parameter Name="AzureTenantId" DefaultValue="" />
  <Parameter Name="AzureClientId" DefaultValue="" />
  <Parameter Name="AzureClientSecret" DefaultValue=""/>
  <Parameter Name="AzureKeyVaultUri" DefaultValue="" />
  <Parameter Name="ServerPort" DefaultValue="" />
</Parameters>

方式二：通过ConfigPackage中转参数（适合多环境配置场景） #

如果你需要通过ConfigPackage统一管理配置，就要修正ServiceManifest.xml中的环境变量引用语法：

修正后的ServiceManifest.xml（EnvironmentVariables部分）

<EnvironmentVariables>
  <!-- 引用ConfigPackage中的参数，格式：{ConfigPackageName:SectionName:ParameterName} -->
  <EnvironmentVariable Name="AZURE_TENANT_ID" Value="{Config:EnvironmentVariablesSection:AZURE_TENANT_ID}" />
  <EnvironmentVariable Name="AZURE_CLIENT_ID" Value="{Config:EnvironmentVariablesSection:AZURE_CLIENT_ID}" />
  <EnvironmentVariable Name="AZURE_CLIENT_SECRET" Value="{Config:EnvironmentVariablesSection:AZURE_CLIENT_SECRET}" />
  <EnvironmentVariable Name="AZURE_KEYVAULT_ENDPOINT" Value="{Config:EnvironmentVariablesSection:AZURE_KEYVAULT_ENDPOINT}" />
  <EnvironmentVariable Name="SERVER_PORT" Value="{Config:EnvironmentVariablesSection:SERVER_PORT}" />
</EnvironmentVariables>

ApplicationManifest.xml和Settings.xml保持现有配置不变

你的ConfigOverrides逻辑是对的，会把应用参数的值覆盖到ConfigPackage的Settings中，无需修改。

关键验证步骤 #

1. 部署时必须传入实际参数值：
   本地部署时，在Publish Profile（Cloud.xml或Local.xml）的ApplicationParameters节点中填写实际值，或者用PowerShell命令指定：

   Publish-AzServiceFabricApplication `
     -ApplicationParameter @{
       AzureTenantId="your-actual-tenant-id";
       AzureClientId="your-actual-client-id";
       AzureClientSecret="your-actual-client-secret";
       AzureKeyVaultUri="https://your-vault.vault.azure.net/";
       ServerPort="8080"
     } `
     -ApplicationName fabric:/ebxml-demo `
     -ApplicationTypeVersion 1.0.0 `
     -ServiceManifestVersion 1.0.0
   

2. 在Spring Boot中验证环境变量：
   可以在启动类中加一段日志，确认环境变量是否正确读取：

   @SpringBootApplication
   public class DemoApplication {
       public static void main(String[] args) {
           System.out.println("AZURE_TENANT_ID: " + System.getenv("AZURE_TENANT_ID"));
           SpringApplication.run(DemoApplication.class, args);
       }
   }
   

常见坑点提醒 #

• 参数名大小写敏感：Service Fabric的应用参数、Config参数、环境变量名的大小写必须完全匹配，否则会导致映射失败。
• 不要留空默认值：如果部署时忘记传参数，默认值为空字符串也会导致Key Vault初始化失败，建议在ApplicationManifest中给敏感参数设置临时默认值用于测试。

内容来源于stack exchange