Blazor WASM部署Azure静态Web应用时替换appsettings.json值失败求助

问题背景 #

已搭建完成Restore/Build/Test/Publish流水线，可正常将发布工件部署至开发/测试/预生产环境，但针对不同环境修改appsettings.json中API URL的操作未生效。所有流水线任务执行成功，但部署后的代码里未包含设置好的URL。

当前提交的appsettings.json内容：

{
  "HttpClient": {
    "BaseAddress": ""
  }
}

发布流水线任务流程：

1. 从工件压缩包提取文件
2. 使用变量转换提取出的appsettings.json
3. PowerShell脚本输出appsettings.json内容
4. 部署到Azure静态Web应用

流水线YML代码：

steps:
- task: ExtractFiles@1
    displayName: 'Extract files '
    inputs:
    destinationFolder: '$(System.DefaultWorkingDirectory)/blazor'
    overwriteExistingFiles: true
- task: FileTransform@2
    displayName: 'Transform AppSettings'
    inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/blazor'
    jsonTargetFiles: '**/appsettings.json'
- powershell: |
    Get-Content /home/vsts/work/r1/a/blazor/wwwroot/appsettings.json
  displayName: 'PowerShell Script'
- task: AzureStaticWebApp@0
    displayName: 'Static Web App: Blazor WASM'
    inputs:
    workingDirectory: '$(System.DefaultWorkingDirectory)/blazor'
    app_location: /wwwroot
    skip_app_build: true
    skip_api_build: true
    is_static_export: false
    verbose: true
    azure_static_web_apps_api_token: 'XXXXXXXXXX'

已尝试操作：

• 禁用转换步骤，提交含有效URL的appsettings.json部署，功能正常
• 调换提取与转换步骤顺序，问题未解决

排查与解决办法 #

1. 确认流水线变量配置 #

FileTransform任务依赖同名流水线变量完成替换，需确保已在流水线变量中配置HttpClient.BaseAddress，且对应环境的变量值正确（比如开发环境设为https://dev-api.example.com/）。若使用发布流水线，需为每个目标环境单独设置该变量值。

2. 明确FileTransform的文件路径 #

当前jsonTargetFiles用**/appsettings.json匹配所有子目录文件，可改为更精准的路径避免匹配错误：

wwwroot/appsettings.json

3. 验证转换后的文件内容 #

检查PowerShell输出的appsettings.json内容，确认BaseAddress已被正确替换。若输出正确但部署后不生效，需排查AzureStaticWebApp任务的路径配置。

4. 确认AzureStaticWebApp任务路径正确性 #

当前workingDirectory为$(System.DefaultWorkingDirectory)/blazor，app_location为/wwwroot，对应路径应为$(System.DefaultWorkingDirectory)/blazor/wwwroot。可在PowerShell中添加路径验证：

Write-Host "检查目标目录: $(System.DefaultWorkingDirectory)/blazor/wwwroot"
Get-ChildItem $(System.DefaultWorkingDirectory)/blazor/wwwroot

5. 改用PowerShell直接替换 #

若FileTransform任务仍不生效，可替换为PowerShell脚本直接修改文件：

$appSettingsPath = "$(System.DefaultWorkingDirectory)/blazor/wwwroot/appsettings.json"
$jsonContent = Get-Content $appSettingsPath | ConvertFrom-Json
$jsonContent.HttpClient.BaseAddress = "$(HttpClient.BaseAddress)"
$jsonContent | ConvertTo-Json -Depth 10 | Set-Content $appSettingsPath
# 输出验证内容
Get-Content $appSettingsPath

替换原有的FileTransform和PowerShell输出任务，确保HttpClient.BaseAddress变量已正确配置。

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