.NET wwwroot目录下Angular应用刷新后出现404错误排查求助

1. 中间件顺序不符合规范 #

你的Program.cs里中间件加载顺序有误，静态文件处理、CORS这类基础中间件必须放在授权、路由之前，否则会导致静态资源访问异常或路由规则冲突。

修正后的代码：

public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);

    // 注册服务
    builder.Services.AddControllers();
    builder.Services.AddEndpointsApiExplorer();
    builder.Services.AddSwaggerGen();
    builder.Services.AddCors(policy => 
        policy.AddPolicy("AllowAll", opt => opt.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod()));

    var app = builder.Build();

    // 开发环境配置
    if (app.Environment.IsDevelopment())
    {
        app.UseSwagger();
        app.UseSwaggerUI();
    }

    app.UseHttpsRedirection();
    // 静态文件处理必须靠前
    app.UseDefaultFiles();
    app.UseStaticFiles();
    // CORS要在授权和路由之前
    app.UseCors("AllowAll");
    app.UseAuthorization();

    app.MapControllers();
    // 新增SPA fallback路由，处理Angular页面刷新404
    app.MapFallbackToFile("index.html");

    app.Run();
}

2. wwwroot内的web.config完全多余 #

你在wwwroot下放了单独的Angular web.config，这会和根目录的.NET Core web.config冲突，直接删除即可。SPA的路由跳转逻辑交给上面新增的MapFallbackToFile处理就足够了。

3. 缺少SPA fallback路由配置 #

之前的代码没有配置MapFallbackToFile("index.html")，用户刷新Angular路由页面（比如/dashboard）时，IIS会因找不到对应物理文件返回404。添加这个配置后，所有非API、非静态文件的请求都会转发到Angular的index.html，解决刷新页面404的问题。

4. Angular构建的base-href需匹配部署路径 #

如果你的IIS站点部署在虚拟目录下（比如http://localhost/myApp），--base-href=/就不正确，要改成--base-href=/myApp/；如果是根站点部署，这个配置没问题，但要确认构建后的index.html里的<base href="/">标签正确。

5. 需安装SPA扩展包才能使用fallback路由 #

要使用MapFallbackToFile，得先安装NuGet包Microsoft.AspNetCore.SpaServices.Extensions，可以通过命令行安装：

Install-Package Microsoft.AspNetCore.SpaServices.Extensions

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