NX Angular Monorepo的IIS URL Rewrite路由参数问题

核心问题出在IIS对SPA路由的处理逻辑上：Angular是单页应用，所有路由都由前端处理，但IIS默认会把带参数的URL当成物理文件/目录去查找，找不到就触发错误重定向，导致你的带参URL被跳转到父路由。

直接用下面的Web.config配置替换你现有的文件，重点是保留查询参数的传递：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="Angular SPA Routes" stopProcessing="true">
          <match url=".*" />
          <conditions logicalGrouping="MatchAll">
            <!-- 排除真实存在的文件（比如js、css、图片） -->
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <!-- 排除真实存在的目录 -->
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
            <!-- 如果有后端API接口，在这里排除，避免被重写 -->
            <add input="{REQUEST_URI}" pattern="^/(api)" negate="true" />
          </conditions>
          <!-- 重写到index.html，同时自动附加原URL的Query参数 -->
          <action type="Rewrite" url="/index.html" appendQueryString="true" />
        </rule>
      </rules>
    </rewrite>
    <!-- 可选：配置静态资源缓存，提升加载速度 -->
    <staticContent>
      <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="7.00:00:00" />
    </staticContent>
  </system.webServer>
</configuration>

关键注意事项 #

• URL重写模块必须安装：如果IIS里没有这个模块，直接去IIS管理器的「模块」面板添加，或者通过Web平台安装包下载安装，没有它规则不会生效。
• appendQueryString="true"是核心：这个属性会把原URL里的?id=63&type=in-progress这类参数自动带到index.html请求里，Angular启动后就能完整解析整个URL，匹配对应的路由。
• 部署路径要正确：确保NX构建后的产物（一般是dist目录下的对应应用文件夹）完整复制到IIS站点的根目录，index.html必须在根路径下。
• 路由配置验证：确认Angular里的路径路由（比如information-technology/inventory/:uuid）定义正确，查询参数不需要在路由里声明，Angular会自动通过ActivatedRoute获取。

如果之前加过错误的规则，先全部删除再用上面的配置，这样就能解决带参URL直接访问被重定向的问题，同时不会出现404。

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