本地IIS配置index.html URL重写失效，求解决方案

环境信息 #

• 本地机器IP：192.168.0.19
• IIS站点绑定HTTPS 443端口
• 网站应用名称：scheduler
• web.config路径：C:\inetpub\wwwroot\scheduler

问题背景 #

原本期望所有以https://192.168.0.19开头的URL都能重定向到scheduler应用的index.html，但实际访问时始终返回HTTP Error 404.0 - Not Found错误。先后尝试了两套web.config配置，均未解决问题：

最初的web.config配置 #

<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Force Index.html" enabled="true" stopProcessing="true">
                    <match url="(.*)" />
                    <conditions>
                        <add input="{REQUEST_URI}" matchType="IsDirectory" negate="true" />
                        <add input="{REQUEST_URI}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="/index.html" />
                </rule>
                <rule name="Redirect index.html" stopProcessing="true">
                    <match url="(.*)" />
                    <conditions logicalGrouping="MatchAll" trackAllCaptures="false" />
                    <action type="Redirect" url="index.html/" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

修改后的web.config配置 #

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="redirect to scheduler" stopProcessing="true">
                    <match url="(.*)" />
                    <conditions>
                        <add input="{HTTP_HOST}" pattern="^192.168.0.19$" />
                        <add input="{HTTPS}" pattern="on" />
                    </conditions>
                    <action type="Redirect" url="/scheduler/index.html" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

问题分析 #

• 最初配置中的第二个规则Redirect index.html会无条件匹配所有URL并执行重定向，即使已经访问index.html也会被强制跳转到index.html/，导致循环重定向或路径错误，进而触发404。
• 修改后的配置会将所有HTTPS请求直接重定向到/scheduler/index.html，但未排除对实际文件和目录的请求，可能导致静态资源（如CSS、JS）也被重定向，引发404；同时不符合单页应用的路由需求。

正确配置方案 #

以下配置适配单页应用路由场景，确保所有非文件/非目录的请求都重写到index.html，同时根路径访问会直接跳转到应用入口：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <!-- 处理SPA路由：非文件/非目录请求重写到index.html -->
                <rule name="SPA Fallback" enabled="true" stopProcessing="true">
                    <match url=".*" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                        <add input="{REQUEST_URI}" pattern="^/scheduler/index\.html$" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="/scheduler/index.html" />
                </rule>
                <!-- 根路径访问直接跳转到应用入口 -->
                <rule name="Root to Scheduler" enabled="true" stopProcessing="true">
                    <match url="^$" />
                    <conditions>
                        <add input="{HTTP_HOST}" pattern="^192\.168\.0\.19$" />
                        <add input="{HTTPS}" pattern="on" />
                    </conditions>
                    <action type="Redirect" url="/scheduler/index.html" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

配置说明 #

1. SPA Fallback规则：

   • 匹配所有URL，仅当请求既不是实际文件也不是目录时，才执行重写操作。
   • 排除了对/scheduler/index.html的匹配，避免循环重写。
   • 使用Rewrite而非Redirect，保证浏览器URL不变，适配单页应用前端路由。

2. Root to Scheduler规则：

   • 仅匹配根路径（https://192.168.0.19/），直接重定向到应用的index.html，确保根路径访问能正确进入应用。

注意事项 #

• 确保IIS已安装并启用URL重写模块，如果未安装，可通过IIS管理器的“管理模块”或Web平台安装程序添加。
• 验证C:\inetpub\wwwroot\scheduler\index.html文件确实存在，路径无误。

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