Blazor组件迁移至共享库：Server转WASM时路由失效咨询

Blazor 客户端路由系统默认仅扫描启动项目（即当前从Blazor Server迁移而来的.Cliente WASM项目）自身程序集内标注了@page指令的可路由组件，不会自动遍历引用的外部类库，因此完全无法识别.components共享库内的页面定义。

1. 注册共享库的路由扫描范围 #

打开.Cliente项目下的根组件App.razor，找到<Router>组件的原始定义。默认配置下Router只会绑定主项目自身的程序集：

<Router AppAssembly="typeof(Program).Assembly">

你需要通过AdditionalAssemblies参数显式告知路由系统需要扫描的额外程序集：

• 引用.components共享库内任意一个公开类型（可以是任意公开组件、公共基类，只要是类库中可被主项目访问的类型即可），通过该类型获取共享库的程序集实例
• 将共享库的程序集追加到路由扫描列表中，修改后的示例代码：

@* 引入共享库的类型空间，用于获取程序集实例 *@
@using Blazor.Components

<Router AppAssembly="typeof(Program).Assembly"
        AdditionalAssemblies="new[] { typeof(SharedPageBase).Assembly }">

配置完成后，路由系统会同时扫描主项目和共享库内的所有带@page的页面组件。

2. 设置共享库页面的加载优先级 #

路由匹配的默认优先级规则是：

1. 优先匹配AppAssembly参数指定程序集内的所有路由
2. 按照AdditionalAssemblies数组的传入顺序，依次匹配列表中程序集的路由

如果要让共享库的页面优先于主项目的页面加载，分两种场景处理：

• 无路由冲突场景：保持上述配置即可，只要主项目没有和共享库同路径的路由，所有页面都能正常被识别
• 存在同路径路由冲突场景（比如两边都定义了@page "/"的Index页面）：有两种方案实现共享库优先：
  1. 直接移除主项目内和共享库路径冲突的页面组件：这是迁移阶段最干净的处理方式，避免冗余代码和逻辑冲突
  2. 调整Router组件的程序集传入顺序：将共享库的程序集作为AppAssembly参数传入，把主项目的程序集放到AdditionalAssemblies列表中，这样路由会优先扫描匹配共享库内的页面，再匹配主项目的页面：

     <Router AppAssembly="typeof(SharedPageBase).Assembly"
             AdditionalAssemblies="new[] { typeof(Program).Assembly }">
     

• 确保.components共享库的目标框架版本和主WASM项目完全一致，避免因程序集不兼容导致路由扫描失败
• 确认共享库内的页面组件为公开可访问类，且正确标注了@page路由指令，非公开组件不会被路由系统识别
• 检查主项目的依赖配置：确保.components共享库是以项目引用的方式添加到主项目依赖中，避免发布打包时类库文件未被正确打包，导致运行时找不到路由

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