添加客户详情Razor页面后网站加载空白，请求技术排查

核心问题场景 #

项目基于Blazor构建：通过Razor组件展示客户列表，列表项链接到详情Razor页面（传入客户ID展示详情）。将详情页放入routes文件夹后，网站启动直接显示空白；移除该页面后恢复正常。列表页的OnInitializedAsync断点从未触发，说明应用初始化阶段已失败，而非详情页加载时的问题。

排查与解决方向 #

• 路由配置冲突
  Blazor框架对路由目录可能有特殊处理，routes文件夹下的页面路由模板若与现有路由重叠，会导致路由解析异常，应用启动失败。检查详情页的@page指令，比如若写为@page "/customer/{Id}"，可能和根路由或其他组件路由冲突。
  解决：将详情页移出routes文件夹，或修改路由模板为@page "/routes/customer/{Id}"，确保路由唯一。

• 文件夹编译/权限问题
  部分Blazor模板中routes目录可能被项目配置排除编译，或存在权限限制导致页面无法加载。查看项目文件（.csproj）是否有<ExcludeFromBuild>规则包含routes文件夹，同时检查VS输出窗口的编译日志，确认是否有编译警告或错误。
  解决：移除项目文件中对routes文件夹的排除配置，修复编译日志中的错误项。

• 详情页初始化代码异常
  详情页的构造函数、静态初始化代码或OnInitializedAsync方法若存在未处理异常，会导致应用启动时崩溃（无错误提示仅空白）。比如引用了未注册的服务、空指针异常等。
  解决：暂时注释详情页的所有业务代码，仅保留@page指令和空页面内容，启动验证是否正常。若恢复正常，再逐步添加代码定位问题点。

• 路由注册顺序问题
  Blazor Server项目中，Program.cs的路由注册顺序可能影响系统加载。若routes文件夹下的页面路由被优先匹配，但页面加载存在问题，会导致整个路由系统故障。
  解决：检查Program.cs中的路由配置，确保MapBlazorHub()和MapFallbackToPage("/_Host")（Server）或MapFallbackToFile("index.html")（WASM）配置正确，未被其他路由规则干扰。

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