Blazor AOT编译后dotnet.wasm体积大内存占用高如何优化？

体积与内存优化方案 #

• 显式启用IL裁剪：在项目.csproj文件的PropertyGroup节点中添加<BlazorWebAssemblyEnableLinking>true</BlazorWebAssemblyEnableLinking>，强制裁剪所有未被引用的代码逻辑。如果项目用到反射、动态类型相关能力，需要额外配置裁剪豁免规则，避免运行时报错。
• 限制AOT编译范围：默认AOT会编译所有引用的程序集，可将非核心业务的第三方库排除出AOT范围，仅保留解释执行模式，配置示例如下：

<ItemGroup>
  <!-- 按名称指定不需要AOT编译的程序集 -->
  <BlazorWebAssemblyAotExclude Include="Newtonsoft.Json" />
  <!-- 支持通配符匹配一类程序集 -->
  <BlazorWebAssemblyAotExclude Include="*.Utility" />
</ItemGroup>

该方案可大幅减少AOT生成的冗余机器码，同时大部分第三方库解释执行的性能损失可忽略，也能解决AOT运行速度低于解释器的问题。

• 关闭不需要的运行时特性：在PropertyGroup中添加<WasmEnableSIMD>false</WasmEnableSIMD>、<WasmEnableEH>false</WasmEnableEH>（项目不需要SIMD指令、高级异常捕获能力时可开启），可减少15%~25%的AOT代码体积。
• 升级.NET SDK版本：你当前使用的.NET 6 RC1属于预览版本，该版本的AOT实现存在已知的冗余代码生成、体积计算异常缺陷，升级到.NET 6正式版或更高LTS版本（如.NET 8），同项目AOT体积可降低40%以上，内存占用也会有明显优化。
• 启用资源压缩与延迟加载：发布时开启gzip/Brotli压缩，配置服务器端对应压缩规则，可减少70%以上的传输体积；非首屏用到的程序集配置为延迟加载，减少启动时加载的资源体积。

可用分析工具 #

• 程序集体积分析：发布项目后，在输出目录执行dotnet wasm dump size命令，可输出每个参与AOT编译的程序集对应的wasm代码段占比，直接定位体积占比最高的程序集。
• 内存占用分析：
  • 用浏览器开发者工具的Memory面板抓取堆快照，筛选WebAssembly.Module相关内存块，可查看dotnet.wasm的实际加载内存占用，以及托管堆的分配情况。
  • 在项目文件添加<WasmEnablePerfTracing>true</WasmEnablePerfTracing>开启性能 tracing，运行时可查看每个程序集的内存占用、函数调用耗时，定位高开销的逻辑。
• 依赖树分析：执行dotnet list package --include-transitive命令，输出所有传递依赖的第三方库，可排查未使用但被间接引入的冗余依赖。

第三方库问题定位步骤 #

1. 执行dotnet publish -c Release生成Release版本的AOT编译产物，运行体积分析命令得到各程序集的体积占比排序，标记占比超过5%的非官方程序集。
2. 逐个临时移除标记的第三方库，用极简实现替代对应功能后重新发布，观察dotnet.wasm体积和内存占用的变化，即可定位到引发异常的依赖库。
3. 对于必须保留的高体积第三方库，将其加入AOT排除列表即可快速缓解体积和内存问题。

内容的提问来源于stack exchange，提问作者lilo.jacob