ASP.NET Core部署Azure时服务器端404重定向异常问题

这种情况我在部署React+ASP.NET Core的SPA到Azure App Service时遇到过好几次，本地IIS Express正常但Azure出问题，通常是因为Azure的请求处理规则和本地环境有差异，咱们一步步来排查解决：

1. 检查ASP.NET Core中间件的顺序 #

中间件的执行顺序直接影响功能是否生效，一定要确保UseStatusCodePagesWithReExecute在路由/API端点配置之前加载。正确的Startup配置示例如下：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 先配置静态文件服务
    app.UseStaticFiles();

    // 配置状态码页面重定向逻辑
    app.UseStatusCodePagesWithReExecute("/");

    // 再配置路由与授权
    app.UseRouting();
    app.UseAuthorization();

    // 映射API控制器端点
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });

    // 配置SPA中间件（适配React项目）
    app.UseSpa(spa =>
    {
        spa.Options.SourcePath = "ClientApp"; // 替换成你的React项目路径
        if (env.IsDevelopment())
        {
            spa.UseReactDevelopmentServer(npmScript: "start");
        }
    });
}

2. 添加Azure专属的URL重写规则 #

Azure App Service依赖web.config处理请求路由，即使是ASP.NET Core项目，也需要额外配置重写规则，确保非API、非静态资源的请求都转发到index.html，让React Router和后端404逻辑协同工作。

在项目根目录创建或修改web.config文件，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <!-- 让API请求直接走后端逻辑 -->
        <rule name="API Routes" stopProcessing="true">
          <match url="^api/" />
          <action type="None" />
        </rule>
        <!-- 静态文件直接返回，不经过重写 -->
        <rule name="Static Files" stopProcessing="true">
          <match url="([\S]+[.](html|css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot))" />
          <action type="None" />
        </rule>
        <!-- 其他所有请求转发到index.html，交给React Router处理 -->
        <rule name="SPA Fallback" stopProcessing="true">
          <match url=".*" />
          <action type="Rewrite" url="/index.html" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

3. 验证Azure App Service的默认文档设置 #

登录Azure Portal，进入你的App Service，打开配置 > 默认文档，确保index.html在默认文档列表的最顶部。如果没有就添加它并调整顺序，让Azure优先以index.html作为入口页。

4. 调整重定向目标路径 #

有时候在Azure环境下，直接用"/"可能不如"/index.html"可靠，你可以尝试把重定向配置改成：

app.UseStatusCodePagesWithReExecute("/index.html");

这样能确保重定向直接指向SPA的入口文件，避免路径解析的歧义。

5. 检查部署完整性 #

如果用Azure DevOps或GitHub Actions部署，要确认部署过程中没有覆盖或修改web.config文件。可以通过Azure App Service的高级工具 > Kudu，查看site/wwwroot目录下的web.config是否和本地一致。

按这些步骤调整后，应该就能解决Azure上非法路径的404重定向问题了，我之前就是靠这套方案搞定类似场景的。

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