Azure Functions Deploy任务应用配置值转义异常：多余反斜杠自动添加

问题核心 #

通过Azure DevOps经典发布管道部署函数应用时，多行配置值会被自动转换为Windows风格的\r\n换行，导致SFTP连接失败；手动通过门户高级编辑设置\n可正常工作，但自动部署及Key Vault集成场景下无法识别正确换行符。

解决方案 #

1. DevOps经典发布管道内预处理配置值 #

在部署任务前添加PowerShell脚本，将配置值转换为Unix风格\n换行：

• 添加PowerShell任务，脚本内容：

  # 读取原始配置变量
  $rawValue = "$(YourConfigVariable)"
  # 替换Windows换行为Unix换行
  $processedValue = $rawValue -replace "`r`n", "`n"
  # 将处理后的值设为管道变量，供后续部署任务使用
  Write-Host "##vso[task.setvariable variable=ProcessedConfig]$processedValue"
  

• 在Azure函数应用部署任务的应用设置中，使用$(ProcessedConfig)作为目标配置值。

2. Key Vault密钥的换行符处理 #

直接存储或更新密钥为Unix风格换行：

• 写入新密钥：使用Azure CLI或PowerShell确保存储\n换行：

  az keyvault secret set --name "SFTP-PrivateKey" --vault-name "YourVaultName" --value $'abc\ndef\nghi'
  

• 更新现有密钥：转换已存储的\r\n为\n：

  $secret = Get-AzKeyVaultSecret -VaultName "YourVaultName" -Name "SFTP-PrivateKey"
  $unixValue = $secret.SecretValueText -replace "`r`n", "`n"
  Set-AzKeyVaultSecret -VaultName "YourVaultName" -Name "SFTP-PrivateKey" -SecretValue (ConvertTo-SecureString $unixValue -AsPlainText -Force)
  

• 函数端读取时直接使用环境变量值，无需额外转义（如C#中Environment.GetEnvironmentVariable("SFTP-PrivateKey")）。

3. 部署任务的应用设置配置 #

使用JSON格式定义应用设置，确保换行符为\n：

• 在Azure函数应用部署任务的"应用设置"中，选择"使用JSON格式"，填入：

  {
    "SFTP-PrivateKey": "abc\ndef\nghi"
  }
  

  此方式会直接将\n写入底层配置，避免自动转换为\r\n。

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