.NET 8 Blazor Web App部分@page路由失效返回404原因排查

以下是针对你遇到的.NET 8 Blazor Web App（Server+WA）部分路由失效问题的排查方向：

• 文件未被项目正确包含：检查路由失效的.razor文件的生成操作是否为Content，打开项目文件（.csproj）确认没有将该文件标记为None。Blazor仅编译项目中显式包含的组件，未包含的文件不会注册路由。
• 路由冲突或命名空间问题：用dotnet watch run启动项目，查看控制台输出是否有路由重复警告；确认组件命名空间是否与其他路由组件冲突，命名空间会影响Blazor的路由发现逻辑。
• 静态文件拦截：若路由路径（如/c）与wwwroot下的静态文件/目录重名，ASP.NET Core会优先返回静态文件，导致Blazor路由失效。检查wwwroot目录是否存在同名资源。
• 组件基类干扰：如果失效组件继承了自定义基类，尝试改为直接继承ComponentBase测试，排除基类重写路由逻辑的可能。
• 模式差异导致的路由注册问题：Server模式依赖服务端编译时的组件发现，WA模式需要确保Program.cs中正确配置AddRazorComponents().AddInteractiveWebAssemblyComponents()，且_Imports.razor导入了组件所在命名空间。
• 编译缓存问题：执行dotnet clean && dotnet build清理bin/obj目录后重新编译，或临时在.csproj中添加<RazorCompileOnBuild>false</RazorCompileOnBuild>禁用Razor编译缓存测试。

这种情况基本是项目配置或文件状态问题，而非.NET 8 Blazor的官方Bug。若以上排查无效，可尝试在全新Blazor项目中复制组件测试，若问题复现再考虑提交官方Bug。

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