HTTPS环境运行Angular应用点击下载链接报Cannot match any routes错误如何解决

该问题不需要调整应用程序池相关配置，核心原因是Angular前端路由接管了同域下/api前缀的请求，配合IIS URL重写规则的适配漏洞，导致HTTPS环境下请求被转发到前端路由匹配，而非交给后端.NET API处理，可按以下步骤修复：

修复步骤 #

• 第一步：修改IIS URL重写规则，排除API路径的前端路由转发
  部署Angular SPA时通常会在站点根目录的web.config中配置规则，将所有非静态资源请求重写到index.html交由前端路由处理，你需要新增/api前缀的请求排除条件，配置示例如下：

<rule name="Angular SPA Routes" stopProcessing="true">
  <match url=".*" />
  <conditions logicalGrouping="MatchAll">
    <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>
  <action type="Rewrite" url="/index.html" />
</rule>

修改完成后重启IIS站点即可生效。如果HTTP环境下功能正常，大概率是HTTPS站点部署时未同步更新web.config，或是原有规则存在仅适配HTTP的过滤条件导致失效，直接替换为上述规则即可。

• 第二步：给下载锚点标签添加Angular路由忽略标识
  Angular默认会拦截同域下所有a标签的点击事件交由前端路由处理，给下载标签添加ngNoRouter属性即可禁止路由拦截，让浏览器原生处理下载请求，标签示例如下：

<a href="/api/ServerMethods/DownloadFile?fName=xxx&ID=xxx" ngNoRouter>下载文件</a>

也可额外添加download属性指定下载文件名，进一步优化用户体验。

• 第三步：验证HTTPS站点的路径映射
  确认IIS中HTTPS绑定的站点根目录、/api对应的虚拟目录/应用配置与HTTP站点完全一致，避免因路径映射差异导致请求找不到后端API入口。

现象说明 #

Postman直接向后端发起HTTPS请求，没有经过Angular应用加载流程，不会触发前端路由逻辑；右键「链接另存为」是浏览器原生的资源请求行为，也不会触发Angular的点击拦截逻辑，因此两者都能正常下载。

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