ASP.NET Core Blazor WebAssembly 调试时浏览器崩溃问题分析与解决

2025-05-03 23:20:48作者：温玫谨Lighthearted

项目地址：https://gitcode.com/gh_mirrors/aspnet/aspnetcore

问题背景

在ASP.NET Core Blazor WebAssembly开发过程中，使用Visual Studio 2022进行调试时，开发者可能会遇到浏览器突然崩溃的问题。特别是在升级到Chromium 135+版本后，这个问题变得更加明显。本文将深入分析这一问题的成因，并提供有效的解决方案。

问题现象

当开发者使用Visual Studio 2022 17.13.5版本调试Blazor WebAssembly Hosted PWA应用时，浏览器(Edge/Chrome)会在启动后立即崩溃，并显示"STATUS_ACCESS_VIOLATION"错误。这种情况通常发生在Service Worker激活的状态下，且主要影响Chromium 135.0.7049.85及以上版本。

根本原因分析

经过深入调查，发现该问题通常由以下因素引起：

JavaScript执行时机问题：在Blazor运行时完全初始化前执行的脚本可能会导致调试代理崩溃
全局变量访问冲突：尝试访问未定义的全局变量或属性会触发TypeError
调试代理兼容性问题：Chromium 135+版本与Visual Studio调试代理之间存在兼容性问题

解决方案

1. 检查并修正head中的脚本

在App.razor文件的head部分，移除或修改任何可能在Blazor初始化前执行的脚本。特别是那些试图访问全局变量或DOM元素的脚本。

<!-- 错误示例 -->
<head>
    <script>
        // 这个脚本在Blazor初始化前执行，可能导致问题
        document.documentElement.style.setProperty('--my-var', 'value');
    </script>
</head>

<!-- 正确做法 -->
<head>
    <!-- 避免在此处放置立即执行的脚本 -->
</head>

2. 使用正确的脚本加载方式

如果需要执行初始化脚本，应该确保它们在Blazor完全加载后执行：

<body>
    <!-- 其他内容 -->
    <script>
        // 在Blazor加载完成后执行
        Blazor.start().then(() => {
            // 安全地执行初始化代码
            document.documentElement.style.setProperty('--my-var', 'value');
        });
    </script>
</body>