MudBlazor服务端应用无法导航至新增Razor页面求助

• 检查页面存放目录
  Blazor Server默认扫描Pages目录下的Razor页面进行路由注册。如果新增的Parms3.razor不在Pages文件夹中，需要在Program.cs里配置路由扫描范围：

  builder.Services.AddRazorPages(options =>
  {
      // 添加自定义目录的路由扫描规则
      options.Conventions.AddPageRoute("/YourCustomFolder/Parms3", "/parms3");
  });
  

• 排查路由冲突
  确认没有其他页面使用了相同的@page "/parms3"路由，或者存在优先级更高的路由（比如带参数的@page "/parms/{id}"）。可以开启路由调试日志查看匹配过程：

  builder.Logging.AddFilter("Microsoft.AspNetCore.Routing", LogLevel.Debug);
  

  启动应用后查看日志，确认请求/parms3时的路由匹配细节。

• 清理项目缓存并重建
  项目缓存可能导致新增页面未被编译注册，执行以下操作：

  1. 关闭当前IDE
  2. 删除项目目录下的bin和obj文件夹
  3. 重新打开项目并生成解决方案

• 验证路由跳转逻辑
  通过NavigationManager手动测试跳转，排除MudNavLink的潜在问题：
  在任意组件中注入NavigationManager并添加跳转方法：

  [Inject]
  private NavigationManager NavManager { get; set; }
  
  public void NavigateToParms3()
  {
      NavManager.NavigateTo("/parms3");
  }
  

  调用该方法测试是否能正常跳转至目标页面。

• 检查页面编译状态
  确保Parms3.razor没有语法错误，哪怕微小的错误都可能导致页面无法被正确编译。可以添加简单测试代码验证：

  @page "/parms3"
  <h3>Parms3</h3>
  <p>@TestContent</p>
  @code {
      private string TestContent = "页面加载正常";
  }
  

  重新生成项目，若存在编译错误，修复后再测试导航。

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