Blazor重复@page路由疑问：删除文件后报错未解决的原因探究

你遇到的错误提示为「路由名称已被映射到其他组件，路由名称必须唯一」，这种情况的核心原因和解决办法如下：

核心原因 #

• 编译产物残留：删除Component.razor源文件后，项目的bin和obj目录里可能还保留着该组件编译后的.dll、.pdb等文件。Blazor编译时会扫描所有编译产物生成路由表，这些残留文件里的重复路由信息会继续生效，触发冲突。
• VS增量编译的局限性：VS的「重建项目」操作并非总是彻底清理旧产物，增量编译优化会保留部分未变更的文件，旧组件的路由信息因此没被完全移除。
• 缓存范围不匹配：CTRL+F5仅清除浏览器的静态资源缓存，但Blazor的路由表是在编译阶段生成并嵌入到应用程序集里的，和浏览器缓存无关，所以清浏览器缓存无法解决问题。

彻底解决的正确步骤 #

如果不想修改路由，按以下操作可以彻底解决：

1. 关闭Visual Studio
2. 手动删除项目根目录下的bin和obj两个文件夹
3. 重新打开项目并执行「重建解决方案」

关于VS行为不一致的说明 #

Blazor项目的路由收集依赖编译阶段的完整扫描，VS的增量编译为了提升速度，会避免重复编译未变更的部分，当删除组件时，部分关联的编译产物可能没被自动清理，就会出现这种“源文件删了但路由还存在”的不一致情况，属于IDE增量编译优化带来的副作用。

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