修改launchSettings切换环境后Blazor WASM前端报404无法访问

问题本质 #

Swagger作为后端直接注册的中间件端点，不依赖Blazor静态文件托管逻辑，所以所有环境下都能正常访问；前端返回404的核心原因是Blazor WASM托管必需的核心中间件没有在非Development环境下生效，通常是中间件被错误包裹在环境判断分支中，或者缺失了路由回退配置。

修复步骤 #

• 调整Startup.Configure方法的中间件顺序，把以下核心托管逻辑从环境判断的if/else分支中移出，确保所有运行环境都会执行：

// HTTPS跳转
app.UseHttpsRedirection();
// WASM框架文件托管，负责加载_framework目录下的Blazor运行时资源，漏了就无法加载前端
app.UseBlazorFrameworkFiles();
// 通用静态文件托管
app.UseStaticFiles();
app.UseRouting();

// 鉴权、Swagger等自定义中间件可放在这部分，Swagger可按需按环境判断是否启用
// app.UseAuthentication();
// app.UseAuthorization();

// 端点配置
app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
    endpoints.MapControllers();
    // 路由回退规则：所有未匹配到后端端点/静态文件的请求，统一返回WASM入口index.html，解决前端路由404问题
    // 该规则必须所有环境都生效，不能放在环境判断分支里
    endpoints.MapFallbackToFile("index.html");
});

• 修正环境判断逻辑，不要用!env.IsProduction()作为开发分支的判断条件，避免Stage、自定义环境误加载开发调试中间件，调整为精准匹配Development环境：

if (env.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
    // WASM调试代理仅开发环境需要
    app.UseWebAssemblyDebugging();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

• 现有launchSettings中的环境变量配置没有问题，不需要修改，调整完中间件代码后重新启动项目即可。

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