Blazor Server中Router组件加载额外程序集时不识别@page路由声明

看起来你遇到的核心问题是额外程序集里的Razor页面路由元数据没有被正确识别，导致Router默认把它们映射到根路由/，和主程序的Index页面冲突。下面是一步步的排查和解决方法：

1. 确认额外程序集是Razor类库（RCL） #

Blazor的路由依赖编译时生成的RouteAttribute，只有Razor类库项目才会自动为@page指令生成这些元数据。如果你的OtherComponents是普通类库，需要修改它的项目文件：

打开OtherComponents.csproj，确保开头的Sdk是Microsoft.NET.Sdk.Razor，而非默认的Microsoft.NET.Sdk，同时添加必要的Razor支持配置：

<Project Sdk="Microsoft.NET.Sdk.Razor">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework> <!-- 匹配主项目的框架版本 -->
    <AddRazorSupportForMvc>true</AddRazorSupportForMvc>
  </PropertyGroup>
</Project>

2. 检查Router组件的程序集配置 #

确保你在Router中正确传入了所有包含Razor页面的程序集。推荐通过程序集中的具体类型来获取实例，避免硬编码名称出错：

<Router AppAssembly="@typeof(App).Assembly"
        AdditionalAssemblies="new[] { typeof(OtherComponents.Pages.ConfigPage).Assembly }">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
    </Found>
    <NotFound>
        <LayoutView Layout="@typeof(MainLayout)">
            <p role="alert">Sorry, there's nothing at this address.</p>
        </LayoutView>
    </NotFound>
</Router>

如果有多个额外程序集，全部加到AdditionalAssemblies数组中即可。

3. 清理编译缓存并重建所有项目 #

编译缓存有时会导致路由元数据未更新，尤其是刚把普通类库改成RCL的场景。执行以下操作：

• 右键解决方案 → 清理解决方案
• 手动删除所有项目下的bin和obj文件夹
• 右键解决方案 → 重建解决方案

4. 验证页面的@page指令是否正确 #

检查OtherComponents里的ConfigPage.razor，确保@page指令没有拼写错误（比如多余空格、大小写问题）：

@page "/config"

<h3>Config Page</h3>
<!-- 页面内容 -->

同时确认页面没有编译错误（比如代码逻辑问题导致无法生成路由元数据）。

5. Blazor Web App特殊注意事项 #

如果你的项目是Blazor Web App（托管/独立模式），需要额外注意：

• 服务器端项目也要引用额外程序集，并在服务器端的Router中配置AdditionalAssemblies
• 客户端项目同样需要引用额外程序集，确保客户端路由能扫描到正确页面

按照这些步骤操作后，Router应该能正确识别额外程序集里的@page路由定义，不会再出现/路由的歧义问题。

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