发布.NET 6 React SPA至IIS报错：默认页中间件找不到/index.html

报错核心是多位置SPA路径配置不一致+中间件重复注册，具体问题点：

• AddSpaStaticFiles配置的静态资源根路径为Web/dist，但React项目实际构建输出目录是Web/build，中间件从起始路径就找错了文件夹
• 重复调用两次UseSpaStaticFiles，第一次还手动指定了错误的RequestPath，将静态资源访问路径映射到/Web/build，和默认根路径规则冲突
• 原发布命令未明确指定Release配置，存在Debug模式下跳过前端生产构建、资源未生成的可能
• 重复注册了两次异常处理中间件，会干扰错误返回逻辑

1. 修正Program.cs配置 #

首先引入所需命名空间：

using Microsoft.Extensions.FileProviders;

第一步，修改SpaStaticFiles注册的根路径，将错误的dist改为实际的build目录：

// 原代码为opt.RootPath = $"{spaSrcPath}/dist"，修改为build路径
builder.Services.AddSpaStaticFiles(opt => opt.RootPath = $"{spaSrcPath}/build");

第二步，删除重复、错误的静态文件中间件注册，仅保留一次UseSpaStaticFiles调用：

app.UseHttpsRedirection();
// 删除下方错误配置行
// app.UseSpaStaticFiles(new StaticFileOptions { RequestPath = $"/{spaSrcPath}/build" });
app.UseSpaStaticFiles();
app.UseRouting();

第三步，删除Production环境判断中多余的异常处理注册，同时给Spa中间件明确指定默认页的文件提供程序，避免路径匹配错误：

// 删掉Production判断块中这行重复配置
// app.UseExceptionHandler("/Error");

// 修改Spa中间件配置
app.UseSpa(spa =>
{
    spa.Options.SourcePath = spaSrcPath;
    // 明确指定默认页从build目录读取
    spa.Options.DefaultPageStaticFileOptions = new StaticFileOptions
    {
        FileProvider = new PhysicalFileProvider(
            Path.Combine(app.Environment.ContentRootPath, spaSrcPath, "build")
        )
    };
    if (app.Environment.IsDevelopment())
        spa.UseReactDevelopmentServer(npmScript: "start");
});

2. 修正发布命令 #

原命令未指定构建配置，改为明确指定Release、目标运行时的命令，确保发布时执行生产环境前端构建：

dotnet publish -c Release -r win-x64 --self-contained false

3. 部署前校验&IIS配置 #

• 发布完成后，直接打开发布输出目录（默认路径为bin/Release/net6.0/win-x64/publish），确认Web/build/index.html文件存在；如果文件不存在，先手动进入项目的Web目录执行npm run build，确认前端能正常构建出文件后再重新发布
• IIS站点的物理路径必须指向publish输出的根目录（即包含MyDemoProject.dll的文件夹），不要指向build子目录或其他位置
• 给IIS应用程序池绑定的账号，授予整个publish目录的读取权限，避免权限不足无法读取静态文件
• 确认服务器已安装.NET 6 Hosting Bundle，否则IIS无法正常运行.NET 6应用，安装完成后需重启IIS生效

修改完成后本地先切Production模式测试：在项目根目录执行dotnet run --environment Production，访问站点地址如果能正常加载首页，说明配置无误，再往IIS部署即可。

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