新服务器上Rewrite规则失效问题排查求助

问题背景 #

搭建新内部系统，复用旧项目web.config的Rewrite规则：

• 系统结构：根目录部署GUI，api文件夹提供.NET6接口服务，保留与主目录结构一致的dev测试目录（后续计划改用独立dev域名）
• 异常现象：主目录接口（如api/test/ping）正常访问，dev目录下的API接口（如dev/api/test/ping）报500错误，但dev/index.html及邮件图片资源可正常加载

核心排查方向 #

1. IIS应用程序配置缺失 #

主目录的api已配置为.NET6应用程序，但dev目录可能未在IIS中设置为独立应用程序，导致请求无法被.NET6运行时处理，触发服务器内部错误。

• 验证操作：在IIS管理器中检查dev目录属性，确认其应用程序状态为已启用，且应用程序池与主目录api使用相同的.NET6兼容池（如ASP.NET Core V6.0）。

2. Rewrite规则未适配dev/api路由 #

原规则仅排除/dev/api请求被重写到前端页面，但未确保这类请求能正确路由到dev目录下的API应用。若API依赖根路径路由（如[Route("api/[controller]")]），直接请求/dev/api/xxx会因路径前缀不匹配导致路由失败。

针对性修复方案 #

方案1：修正IIS应用程序配置 #

1. 打开IIS管理器，找到站点下的dev目录；
2. 右键点击dev目录，选择「转换为应用程序」，关联正确的.NET6应用程序池；
3. 重新测试dev/api/test/ping接口。

方案2：调整Rewrite规则（适配API请求路由） #

添加专门处理dev/api请求的规则，确保请求直接传递到对应应用，修改后的web.config如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
  <rewrite>
      <rules>
        <rule name="Forces HTTPS" patternSyntax="Wildcard" stopProcessing="true">
            <match url="*" />
            <conditions logicalGrouping="MatchAny">
                <add input="{HTTPS}" pattern="off" />
            </conditions>
            <action type="Redirect" url="https://{HTTP_HOST}{REQUEST_URI}" redirectType="Found" />
        </rule>

        <!-- 新增：确保dev/api请求直接传递到对应应用，不做页面重写 -->
        <rule name="Dev API Route" stopProcessing="true">
            <match url="^dev/api(.*)" />
            <conditions logicalGrouping="MatchAll">
                <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            </conditions>
            <action type="Rewrite" url="/dev/api{R:1}" />
        </rule>

        <rule name="Dev Route" stopProcessing="true">
            <match url="^dev(.*)" />
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
              <add input="{REQUEST_URI}" pattern="^/dev/api(.*)" negate="true" />
            </conditions>
            <action type="Rewrite" url="/dev/index.html" />
        </rule>

        <rule name="Angular Routes" stopProcessing="true">
            <match url="^.*$" />
            <conditions logicalGrouping="MatchAll">
              <add input="{REQUEST_URI}" pattern="^/api/template(.*)" negate="true" />
              <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
              <add input="{REQUEST_URI}" pattern="^/api(.*)" negate="true" />
              <add input="{REQUEST_URI}" pattern="^/dev(.*)" negate="true" />
            </conditions>
            <action type="Rewrite" url="index.html?r=error" />
        </rule>
      </rules>
    </rewrite>
</system.webServer>
</configuration>

方案3：调整API路由前缀 #

若dev目录的API是独立部署的.NET6应用，可在API代码中添加路由前缀适配dev路径：

• 在Program.cs中全局设置：

app.MapControllers().AddRoutePrefix("dev/api");

• 或在控制器上单独设置：

[Route("dev/api/[controller]")]
[ApiController]
public class TestController : ControllerBase
{
    // 接口实现
}

额外验证步骤 #

• 查看服务器事件查看器（Windows日志 -> 应用程序），获取500错误的具体异常信息，精准定位问题；
• 测试dev目录下的静态文件（如dev/test.txt）是否可正常访问，确认目录权限和IIS基础配置无误。

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