AOT编译Blazor WASM部署问题：体积过大与缓存失效

咱们逐个分析你遇到的两个问题，给出具体解决思路：

问题1：dotnet.wasm体积87MB是否正常？ #

AOT编译后的dotnet.wasm确实会比JIT模式下的文件大——因为AOT是把IL代码直接编译成WASM原生指令，避免了运行时JIT编译的开销，但代价就是文件体积增加。不过87MB确实偏大，你可以通过以下几点优化缩小体积：

• 启用代码裁剪（Trimming）：这是减小AOT体积最有效的手段之一。在项目文件里添加以下配置，让.NET在发布时自动移除未使用的代码：

  <PublishTrimmed>true</PublishTrimmed>
  <TrimMode>partial</TrimMode> <!-- 先从partial模式开始，避免反射相关问题，后续可尝试full模式 -->
  

• 移除调试符号：发布时确保不包含调试pdb文件，在项目文件里添加：

  <DebugType>none</DebugType>
  

• 确认压缩生效：你已经开启了<BlazorEnableCompression>true</BlazorEnableCompression>，还要确保服务器端启用了gzip或Brotli压缩。可以通过浏览器开发者工具查看响应头是否有Content-Encoding: gzip或br，压缩后87MB的文件通常能缩小到20-30MB左右。
• 清理冗余依赖：用dotnet list package命令检查项目依赖，移除那些实际未使用的NuGet包，减少不必要的代码引入。

问题2：dotnet.wasm无法被浏览器缓存的问题 #

你的缓存头配置看起来没问题，但核心问题可能是缺少Blazor框架文件的专用处理中间件。部署Blazor WASM到Asp.NET Core服务器时，必须先调用UseBlazorFrameworkFiles()来处理_framework目录下的文件，这些文件有特殊的缓存策略和MIME类型处理逻辑。

具体修复步骤： #

1. 调整中间件顺序：在Program.cs中，把UseBlazorFrameworkFiles()放在UseStaticFiles()之前，并且让Blazor自己处理_framework文件的缓存，避免全局缓存配置干扰：

   // 先处理Blazor框架文件，这一步很关键！
   app.UseBlazorFrameworkFiles();
   
   app.UseStaticFiles(new StaticFileOptions()
   {
       ServeUnknownFileTypes = true,
       HttpsCompression = Microsoft.AspNetCore.Http.Features.HttpsCompressionMode.Compress,
       OnPrepareResponse = (context) =>
       {
           // 只给非_framework目录的静态文件设置30天缓存
           if (!context.File.PhysicalPath.Contains("_framework"))
           {
               var headers = context.Context.Response.GetTypedHeaders();
               headers.CacheControl = new Microsoft.Net.Http.Headers.CacheControlHeaderValue
               {
                   Public = true,
                   MaxAge = TimeSpan.FromDays(30)
               };
           }
       }
   });
   

2. 验证缓存是否生效：修改配置后，打开浏览器开发者工具（F12）的Network标签，刷新页面查看dotnet.wasm的状态码：
   • 如果是304 Not Modified，说明浏览器使用了缓存，仅验证文件是否更新；
   • 如果是200 OK但Size列显示from disk cache，也说明缓存生效。
3. 确认BlazorCacheBootResources生效：你已经开启了<BlazorCacheBootResources>true</BlazorCacheBootResources>，这个配置会在构建时生成缓存清单，浏览器会根据清单判断是否需要重新下载资源，确保发布时使用Release模式（dotnet publish -c Release），该配置才会生效。

总结 #

先添加UseBlazorFrameworkFiles()中间件并调整顺序，解决缓存问题；再通过开启代码裁剪、移除调试符号、启用压缩等方式优化dotnet.wasm的体积。按照这些步骤修改后，应该能显著改善加载速度和缓存效果。

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