Azure WebApp Web.config httpErrors重定向异常：如何忽略URL后缀始终显示单页？

你的问题在于，不带后缀的URL（比如example.com/xxxx）没有触发你配置的自定义404处理——这是因为IIS会优先将这类路径视为潜在的目录或ASP.NET路由请求，直接触发了ASP.NET框架本身的404错误，而没有进入httpErrors的处理流程。

要实现无论URL后接什么内容，都返回map.html页面，最可靠的方式是使用IIS的URL Rewrite模块（Azure App Service默认支持这个模块），它能在请求到达应用程序之前就拦截并重写所有符合条件的请求。

修改你的Web.config配置 #

替换或补充现有的配置，加入URL Rewrite规则：

<system.webServer>
  <!-- 保留默认文档配置，确保根路径直接访问map.html -->
  <defaultDocument enabled="true">
    <files>
      <clear />
      <add value="map.html" />
    </files>
  </defaultDocument>

  <!-- 添加URL Rewrite核心规则 -->
  <rewrite>
    <rules>
      <rule name="Rewrite All Non-File/Directory Requests to map.html" stopProcessing="true">
        <!-- 匹配所有不是map.html本身的URL -->
        <match url="^(?!map\.html$).*$" />
        <!-- 排除实际存在的文件和目录（如果你的网站有其他静态资源，比如CSS/JS，这很重要） -->
        <conditions logicalGrouping="MatchAll">
          <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
          <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
        </conditions>
        <!-- 将请求重写到map.html（URL保持用户输入的不变，内容返回map.html） -->
        <action type="Rewrite" url="/map.html" />
      </rule>
    </rules>
  </rewrite>

  <!-- 保留自定义404作为兜底方案 -->
  <httpErrors errorMode="Custom" defaultResponseMode="ExecuteURL">
    <remove statusCode="404" subStatusCode="-1" />
    <error statusCode="404" path="/map.html" responseMode="ExecuteURL" />
  </httpErrors>
</system.webServer>

规则说明 #

• 匹配规则：^(?!map\.html$).*$ 确保不会重写map.html本身的请求，避免循环。
• 条件过滤：排除实际存在的文件和目录，这样如果你的网站有其他静态资源（比如图片、脚本），它们仍能正常访问，不会被重写到map.html。
• 重写动作：type="Rewrite" 会让服务器在后台返回map.html的内容，但用户浏览器的URL保持不变；如果你希望URL跳转到根路径（比如example.com/xxxx变成example.com），可以把type改成Redirect，url改成"/"。

为什么之前的配置无效？ #

当你请求不带后缀的路径时，IIS会先尝试查找对应的物理目录，或者交给ASP.NET路由系统处理，这时候触发的是ASP.NET的HttpException（404），而不是IIS层面的404错误，所以你配置的httpErrors没有生效。URL Rewrite模块在请求管道的更早阶段运行，能拦截所有这类请求，确保它们被正确处理。

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