添加_blazor.server.js后Blazor Server项目出现白屏问题求助

检查脚本引入的位置与格式 #

• 确保脚本在</body>标签前引入，路径必须正确：

  <script src="_framework/blazor.server.js"></script>
  

  不要放在<head>标签内，避免阻塞DOM渲染引发白屏；同时排查是否存在重复引入脚本的情况，重复加载会导致Blazor连接冲突。

验证Blazor Hub端点配置 #

• 打开Program.cs，确认以下配置存在且顺序正确：

  app.MapBlazorHub();
  app.MapFallbackToPage("/_Host");
  

  若这两行被注释或顺序颠倒，会导致Blazor无法建立服务器连接。

清理缓存并重建项目 #

• 清空浏览器缓存（Ctrl+Shift+Del），重点清理本地存储和缓存文件，旧的Blazor缓存可能引发加载异常。
• 在开发工具中执行清理解决方案，随后删除项目根目录下的bin和obj文件夹，最后重建解决方案，避免编译残留文件干扰。

排查浏览器隐藏错误 #

• 打开浏览器开发者工具（F12），查看两个关键标签：
  • 控制台：检查是否有Blazor连接失败的报错（如WebSocket连接超时、Hub地址错误）。
  • 网络：确认_framework/blazor.server.js加载状态为200，同时查看blazor-hub的WebSocket请求是否成功建立连接。

核对环境细节差异 #

• 对比本地与队友的.NET SDK版本（终端执行dotnet --version），确保版本完全一致。
• 修改launchSettings.json中的applicationUrl更换开发服务器端口，排查端口占用问题。
• 暂时关闭本地防火墙、代理工具，测试是否是这类工具拦截了Blazor的WebSocket连接。

检查_Host.cshtml的根组件配置 #

• 确认根组件的渲染模式设置正确：

  <component type="typeof(App)" render-mode="ServerPrerendered" />
  

  若render-mode设为Static，会导致预渲染后无法建立Blazor实时连接，引发白屏。

内容的提问来源于stack exchange，提问作者Matias Ezequiel Roldan