.NET Core2.1+AngularJS网站部署IIS后部分文件请求返回404错误

可能原因 #

1. 静态文件处理链路异常：.NET Core部署IIS时，静态文件请求可能被ASP.NET Core模块错误拦截，或是静态文件中间件配置顺序/内容不全；另外IIS静态文件功能未启用、文件权限不足（IIS_IUSRS无读取权限）也会导致文件存在但返回404。
2. URL重写规则冲突：AngularJS前端路由需要重写规则指向入口页，但规则配置不当会让部分静态文件请求被错误重定向，刷新后浏览器直接请求文件路径，绕过前端路由重写，因此能正常加载。

具体解决步骤 #

1. 修正ASP.NET Core静态文件中间件配置 #

在Startup.cs中确保静态文件中间件优先于路由配置，同时添加SPA fallback规则适配AngularJS路由：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // 先启用静态文件处理
    app.UseStaticFiles();

    // 配置MVC路由
    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
        
        // 非API/静态文件请求 fallback 到index.html，支持AngularJS前端路由
        routes.MapSpaFallbackRoute(
            name: "spa-fallback",
            defaults: new { controller = "Home", action = "Index" });
    });
}

2. 配置web.config重写规则 #

确保重写规则优先排除静态文件和API路径，避免错误拦截：

<rewrite>
  <rules>
    <!-- 直接放行静态文件请求，不执行后续重写 -->
    <rule name="Allow Static Files" stopProcessing="true">
      <match url="([\S]+[.](html|css|js|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot))" />
      <action type="None" />
    </rule>
    <!-- 直接放行API路径请求 -->
    <rule name="Allow API Routes" stopProcessing="true">
      <match url="^api/" />
      <action type="None" />
    </rule>
    <!-- 非文件/目录请求转发到index.html，适配前端路由 -->
    <rule name="SPA Fallback" stopProcessing="true">
      <match url=".*" />
      <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
      </conditions>
      <action type="Rewrite" url="/index.html" />
    </rule>
  </rules>
</rewrite>

3. 检查IIS基础配置与文件权限 #

• 打开IIS管理器，确认站点已启用静态文件功能（功能视图中可查看）。
• 右键网站根目录 → 属性 → 安全，确保IIS_IUSRS用户拥有读取权限，并应用到所有子文件和文件夹。

4. 分析失败请求跟踪日志 #

重点排查：

• 请求路径是否存在编码或大小写问题（Windows文件系统不区分大小写，但IIS部分配置可能导致区分）。
• 重写规则的执行顺序，是否有规则错误拦截了静态文件请求。
• 静态文件模块的处理记录，是否因模块未加载或权限问题返回404。

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