如何在web.release.config中实现URL规则的环境化替换？

以下是我的web.config中URL重写规则的内容：

<rewrite>
  <rules>
    <rule name="GETDOCREDIRECT" stopProcessing="true">
      <match url="(.*)"/>
      <conditions>
        <add input="{REQUEST_URI}" pattern="xyz...."/>
      </conditions>
      <action type="Redirect" url="https://dev.azure.com" appendQueryString="false" 
             redirectType="Permanent"/>
    </rule>
    <rule name="Server_URL" stopProcessing="true">
      <match url="^xyz....."/>
      <action type="Rewrite" url="/^xyz...../"/>
    </rule>
  </rules>
</rewrite>

上述示例中的URL需要根据部署环境动态变更，请问如何修改web.release.config文件，实现类似appsettings和连接字符串那样的环境变量替换？

解决方法 #

你可以利用**XML Document Transform (XDT)**语法，在web.release.config中针对不同环境的URL做精准替换，具体配置如下：

1. 编写web.release.config的变换规则 #

<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <system.webServer>
    <rewrite>
      <rules>
        <!-- 替换GETDOCREDIRECT规则的跳转URL -->
        <rule name="GETDOCREDIRECT" stopProcessing="true" xdt:Locator="Match(name)">
          <action type="Redirect" url="https://prod.azure.com" appendQueryString="false" redirectType="Permanent" 
                  xdt:Transform="SetAttributes(url)"/>
        </rule>

        <!-- 替换Server_URL规则的匹配路径和重写目标 -->
        <rule name="Server_URL" stopProcessing="true" xdt:Locator="Match(name)">
          <match url="^prod....." xdt:Transform="SetAttributes(url)"/>
          <action type="Rewrite" url="/^prod...../" xdt:Transform="SetAttributes(url)"/>
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

2. 核心语法解释 #

• xdt:Locator="Match(name)"：通过规则的name属性精准定位到要修改的重写规则，避免误改其他规则。
• xdt:Transform="SetAttributes(url)"：直接覆盖目标节点的url属性值，替换为当前配置中的环境专属URL。

3. 多环境适配技巧 #

如果需要支持测试、预发布、生产等多个环境，只需创建对应环境的配置文件（比如web.staging.config、web.prod.config），每个文件里写好对应环境的URL值，部署时选择对应的配置文件就能自动完成替换。

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