Blazor WASM默认启动项设置、视图调用及运行报错相关问题

为什么默认将Server项目设为启动项？ #

托管模式的Blazor WASM项目中，Server项目承担两个核心职责：一是托管Client项目编译生成的WASM程序、静态页面资源，二是运行后端API控制器、权限校验、服务端逻辑等能力。默认将Server设为启动项，是为了同时启动静态资源服务和后端接口服务，保证前后端逻辑都能正常被调用。

客户端视图的调用展示流程 #

• 启动Server项目后，浏览器访问根路径时，服务端会首先返回Client项目wwwroot目录下的index.html静态页面
• 页面中嵌入的blazor.webassembly.js脚本被下载执行后，会自动拉取.NET WASM运行时、Client项目编译生成的程序集文件
• 运行时初始化完成后，会将Client项目定义的根组件挂载到index.html中指定的DOM节点（通常是id为app的div），后续页面跳转由Client端Blazor路由系统接管，渲染对应组件的视图内容

两种启动方式异常的原因 #

单独启动Client项目无法访问控制器 #

Client项目本质是纯前端WASM应用，单独启动时仅运行静态资源托管服务，没有加载Server项目的控制器逻辑，所有接口请求都会找不到对应服务端处理程序，因此无法访问控制器。

启动Server项目时提示页面找不到 #

该问题通常是Server项目未正确配置静态资源托管规则导致，常见触发原因如下：

• Server项目未添加对Client项目的项目引用，编译时没有将Client的静态资源复制到Server的输出目录
• Program.cs中缺少app.UseBlazorFrameworkFiles()、app.UseStaticFiles()配置，无法识别并托管Client的WASM相关资源
• 未配置路由回退规则：当请求路径匹配不到API、静态资源时，没有设置回退到index.html的逻辑，也就是缺少app.MapFallbackToFile("index.html")配置

内容的提问来源于stack exchange，提问作者s.vinoth kumar