IIS发布流水线中向Web.config注入Release.ReleaseId失败如何解决？

• 首先明确IIS发布任务的XML变量替换作用范围：默认仅支持appSettings、applicationSettings、connectionStrings三个配置节下的键值对匹配替换，其余自定义配置节或节点属性不会被默认识别。
• 检查web.config的键名配置：需确保web.config中提前定义的键名和变量名完全一致，大小写完全匹配，示例合法配置如下：

<configuration>
  <appSettings>
    <!-- 键名必须和流水线变量名完全一致 -->
    <add key="Release.ReleaseId" value="默认占位符" />
  </appSettings>
</configuration>

附你上传的web.config配置截图：

• 预定义变量层级解析问题排查：部分场景下带点分隔的预定义变量Release.ReleaseId会存在XML替换解析异常，可在流水线变量中新增一个自定义变量，变量名设为ReleaseId，值设为$(Release.ReleaseId)，同时将web.config中的对应键名改为ReleaseId即可解决。
• 变量有效性排查：可在发布任务前新增命令行任务，执行命令echo $(Release.ReleaseId)，运行流水线后查看任务输出，确认该变量在当前阶段可正常取值，排除阶段变量权限限制问题。
• 自定义场景替代方案：如果Release.ReleaseId需要写入非支持配置节，可直接用PowerShell脚本修改web.config，示例脚本如下，将脚本放在XML变量替换步骤之前执行即可：

$configPath = "你的web.config实际物理路径"
$xmlObj = [xml](Get-Content $configPath)
# 下面的节点路径根据你实际配置的位置修改
$targetNode = $xmlObj.SelectSingleNode("//configuration/appSettings/add[@key='Release.ReleaseId']")
$targetNode.value = "$(Release.ReleaseId)"
$xmlObj.Save($configPath)

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