Blazor WebAssembly修改默认启动页不生效问题咨询

修正入口页结构错误 #

你当前的核心错误是将Blazor的挂载根节点<app></app>放在了Razor组件内，这个节点必须定义在静态的dashboard.html页面中，Blazor WASM才能正确加载并渲染组件。dashboard.html需要包含完整的Blazor入口依赖，参考结构如下：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>管理面板</title>
    <base href="/" />
    <link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
    <link href="css/app.css" rel="stylesheet" />
    <link href="你的项目名称.styles.css" rel="stylesheet" />
</head>
<body>
    <app>加载中...</app>
    <script src="_framework/blazor.webassembly.js"></script>
</body>
</html>

同时删除dashboard.razor里的<app></app>标签，仅保留@page "/dashboard"路由声明和业务代码即可。

修改本地调试启动配置 #

要让VS调试时默认打开dashboard.html，任选一种方式修改即可：

• 右键项目 → 选择「属性」→ 切换到「调试」选项卡，在「启动浏览器」输入框中填写dashboard.html，保存后重启调试
• 直接打开项目Properties/launchSettings.json文件，将所有配置项的launchUrl字段值修改为dashboard.html

部署阶段配置（可选） #

如果需要在生产环境将dashboard.html设为默认首页，需要调整Web服务器的默认文档优先级：

• IIS部署：在web.config的<system.webServer>节点下添加如下配置：

<defaultDocument>
  <files>
    <add value="dashboard.html" />
  </files>
</defaultDocument>

• Nginx部署：修改站点配置的index字段，改为index dashboard.html index.html;

根路径跳转配置（可选） #

如果需要用户访问根路径/时自动跳转到dashboard页面，可以在原index.html中添加跳转逻辑：

<script>
    window.location.replace('/dashboard');
</script>

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