Obfuscar能否适配Blazor WebAssembly？混淆后替换DLL加载失败如何解决

你遇到的报错本质和混淆工具无关，是Blazor WebAssembly自带的**子资源完整性校验（SRI）**机制导致的：
Blazor在发布构建时会自动计算所有程序集、静态资源的SHA-256哈希，分别写入blazor.boot.json的资源完整性配置、以及PWA模式下service-worker-assets.js的预缓存清单中。你手动替换混淆后的dll后，文件哈希发生变化，校验不通过就会触发资源拦截、加载失败的报错，哪怕你关闭所有Obfuscar混淆规则，只要重新生成的dll和原始编译的dll哈希不一致，就会出现这个问题。

Obfuscar完全可以用于Blazor WebAssembly项目，核心要求是不能手动替换dll，要将混淆步骤嵌入到项目构建流程中，在Blazor计算资源哈希之前完成混淆，让后续构建流程自动为混淆后的dll生成正确的校验值，具体操作如下：

• 首先在项目中安装Obfuscar的NuGet包：Obfuscar
• 编辑Blazor WASM项目的.csproj文件，添加构建目标，将Obfuscar执行绑定到BeforeComputeBlazorBuildAssets（Blazor计算资源哈希的前置节点）之前执行，示例配置：

<Target Name="Obfuscate" BeforeTargets="BeforeComputeBlazorBuildAssets">
  <Exec Command="obfuscar.console $(ProjectDir)obfuscar.xml" />
  <!-- 用混淆后的dll覆盖编译输出的原始dll，后续构建流程会直接用这个文件计算哈希 -->
  <Copy SourceFiles="$(OutputPath)Confused\$(AssemblyName).dll" DestinationFiles="$(OutputPath)$(AssemblyName).dll" OverwriteReadOnlyFiles="true" />
</Target>

• 编写obfuscar.xml配置文件，必须排除Blazor依赖反射调用的类型（组件类、DI注入类、序列化模型等），避免运行时报错，示例配置：

<?xml version='1.0'?>
<Obfuscator>
  <Var name="InPath" value="bin/Release/netX.x/wwwroot/_framework" />
  <Var name="OutPath" value="bin/Release/netX.x/Confused" />
  <Var name="KeepPublicApi" value="true" />
  <Var name="HidePrivateApi" value="true" />
  <!-- 按需开启混淆规则 -->
  <Var name="RenameFields" value="true" />
  <Var name="RenameProperties" value="true" />
  <Var name="RenameMethods" value="true" />

  <AssemblySearchPath path="bin/Release/netX.x" />
  <Module file="$(AssemblyName).dll">
    <!-- 排除Blazor页面、公共组件 -->
    <SkipNamespace name="你的项目命名空间.Pages" />
    <SkipNamespace name="你的项目命名空间.Shared" />
    <!-- 排除序列化用到的模型类 -->
    <SkipNamespace name="你的项目命名空间.Models" />
    <!-- 排除启动类 -->
    <SkipType name="你的项目命名空间.Program" />
  </Module>
</Obfuscator>

配置完成后直接执行正常的发布操作即可，不需要手动替换任何文件，构建完成后的发布包已经包含混淆后的dll和正确的完整性校验值，不会再出现加载报错。

如果Obfuscar不符合你的使用需求，可以选择以下两款开源免费的替代工具：

• ConfuserEx：功能比Obfuscar更丰富，支持字符串加密、控制流混淆等进阶能力，同样需要将混淆步骤嵌入到Blazor的构建流程中，注意排除反射依赖的类型即可正常使用。
• 轻量.NET混淆工具：基于.NET官方ObfuscationAttribute特性实现，无第三方依赖，适合对混淆强度要求不高的场景。

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