如何正确配置IIS URL Rewrite实现API路径重写并排查500错误

算力阿峰

2026-10-1

配置问题说明

ARR代理未启用：安装ARR模块后默认不会开启反向代理功能，跨站点子应用的重写需要先启用代理才能正常转发请求
重写路径格式错误：原规则的重写目标API.Employees/{R:0}没有前缀斜杠，IIS会将其识别为相对路径，大概率会出现路径解析错误，需要添加前缀斜杠指定为站点根路径下的子应用
正则匹配规则不严谨：原匹配规则^api/teams?(.*)中?会匹配字符s出现0次或1次，会误匹配/api/team这类不存在的路径，且没有覆盖/api/employees路径，需要调整正则覆盖两个接口路径

修正后的配置步骤

启用ARR代理：打开IIS管理器，点击左侧服务器根节点，找到「Application Request Routing Cache」功能，双击进入后点击右侧操作栏的「Server Proxy Settings」，勾选「Enable proxy」后保存配置
替换重写规则：将根站点的重写规则替换为以下配置：

<rewrite>
    <rules>
        <rule name="API.Employees Rewrite" stopProcessing="true">
            <match url="^api/(employees|teams)(.*)$" />
            <action type="Rewrite" url="/API.Employees/{R:0}" appendQueryString="true" logRewrittenUrl="true" />
        </rule>
    </rules>
</rewrite>

可选适配配置：如果子应用仍然识别路径错误，可以在API.Employees应用的Startup.cs/Program.cs中添加PathBase配置：

app.UsePathBase("/API.Employees");

错误详情排查方法

开启IIS详细错误：进入站点的「错误页」功能，点击右侧「编辑功能设置」，选择「详细错误」并保存，访问出错地址即可看到IIS返回的具体错误信息和错误模块
查看IIS访问日志：默认路径为%SystemDrive%\inetpub\logs\LogFiles，找到对应站点ID的日志文件，查看500错误的子状态码，不同子状态码对应不同错误类型：如500.5代表URL重写模块错误，500.21代表模块配置错误
启用失败请求跟踪：在站点的「失败请求跟踪规则」功能中添加规则，跟踪状态码为500的请求，生成的跟踪日志会完整记录URL重写模块的每一步处理过程，可直接定位规则匹配、重写执行的错误点
查看.NET Core应用日志：给API.Employees应用配置文件日志输出，判断请求是否已经转发到应用内部，排查是否为应用代码层面抛出的异常

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