Blazor WASM部署后MSAL认证报错：window.crypto.randomUUID不是函数

问题根源分析 #

window.crypto.randomUUID是现代浏览器提供的API，仅在Chrome 90+、Firefox 95+及更高版本支持。报错通常来自两个场景：

• 运行环境为旧浏览器/受限WebView，不支持该API
• MSAL库版本与.NET 7不兼容，或裁剪过程中误删了JS互操作相关的绑定逻辑

可行解决方案 #

1. 添加crypto.randomUUID Polyfill

在wwwroot/index.html中，Blazor核心脚本加载前插入兼容代码，为不支持的环境提供替代实现：

<script>
if (!window.crypto?.randomUUID) {
  window.crypto.randomUUID = function() {
    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
      const r = crypto.getRandomValues(new Uint8Array(1))[0] % 16 | 0;
      const v = c === 'x' ? r : (r & 0x3 | 0x8);
      return v.toString(16);
    });
  };
}
</script>
<script src="_framework/blazor.webassembly.js"></script>

2. 升级MSAL包到适配.NET 7的稳定版本

确保Microsoft.Authentication.WebAssembly.Msal包版本与.NET 7匹配，建议升级到7.x系列最新版：
修改客户端项目的.csproj文件：

<PackageReference Include="Microsoft.Authentication.WebAssembly.Msal" Version="7.0.14" />

3. 完善裁剪器配置

之前的裁剪规则未覆盖MSAL依赖的核心库，更新LinkerConfig.xml：

<?xml version="1.0" encoding="utf-8" ?>
<linker>
  <assembly fullname="Microsoft.Authentication.WebAssembly.Msal" />
  <assembly fullname="Microsoft.Identity.Client" />
  <type fullname="Microsoft.Authentication.WebAssembly.Msal.Models.*" preserve="all" />
  <type fullname="Microsoft.Identity.Client.*" preserve="all" />
</linker>

同时在.csproj中设置合理的裁剪模式：

<PropertyGroup>
  <BlazorWebAssemblyTrimMode>partial</BlazorWebAssemblyTrimMode>
</PropertyGroup>

4. 验证运行环境兼容性

确认用户使用的浏览器版本符合要求，若需支持旧浏览器，在.csproj中明确目标平台：

<PropertyGroup>
  <TargetFramework>net7.0</TargetFramework>
  <RuntimeIdentifier>browser-wasm</RuntimeIdentifier>
  <SupportedOSPlatformVersion>7.0</SupportedOSPlatformVersion>
</PropertyGroup>

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