配置IIS Rewrite Rule为React应用返回index.html遇问题求助

问题分析 #

你的规则存在三个核心问题：

1. 条件逻辑反向：规则里的negate="true"表示只有当URL不是/Error/NotFound时才执行重定向，所以你遇到的/Error/NotFound?aspxerrorpath=xxxxxxx请求会被直接跳过，不会返回index.html，这和你要让React应用处理所有路由的需求完全相反。
2. 错误的动作类型：使用Redirect会让浏览器地址栏跳转到/index.html，破坏React单页应用的路由逻辑（React需要保持原URL来渲染对应页面），应该用Rewrite进行内部重写，服务器悄悄返回index.html但地址栏不变。
3. 未考虑静态资源：当前规则会把所有请求（包括js、css、图片等静态文件）都重定向/重写到index.html，导致React应用的静态资源无法正常加载。

修正后的重写规则 #

以下是适配React SPA的标准IIS重写规则，会处理所有路由（包括/Error/NotFound这类路径），同时排除静态资源：

<rewrite>
    <rules>
        <rule name="React SPA Rewrite" stopProcessing="true">
            <!-- 匹配所有URL -->
            <match url=".*" />
            <!-- 排除静态资源和已存在的文件/目录 -->
            <conditions logicalGrouping="MatchAll">
                <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                <!-- 如果需要排除特定路径（比如原有的Error页面），可以加这行，否则删掉 -->
                <!-- <add input="{URL}" pattern="^/Error/NotFound" negate="true" /> -->
            </conditions>
            <!-- 内部重写到index.html，地址栏不变 -->
            <action type="Rewrite" url="/index.html" />
        </rule>
    </rules>
</rewrite>

关键说明 #

• Rewrite动作：服务器内部将请求转发到index.html，浏览器地址栏保持原请求URL，React路由可以正常解析路径并渲染对应页面。
• 排除静态资源：通过IsFile和IsDirectory条件，确保真实存在的文件（比如main.js、style.css）和目录不会被重写，保证应用资源正常加载。
• 处理/Error/NotFound：如果需要让React处理这个路径，直接删掉规则里的排除条件即可；如果要保留原IIS的Error页面，再加上那行注释的条件。

针对你当前请求的测试 #

如果你的目标是让http://mypage.com/Error/NotFound?aspxerrorpath=xxxxxxx返回index.html，使用上面的规则后，这个请求会被正常重写，React应用可以捕获这个路径并渲染对应的404页面。

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