Uno Platform WASM应用IIS 10.0部署：AOT及InterpreterAOT构建下dotnet.wasm未缓存致加载缓慢问题排查

首先，根据你描述的现象——Interpreter模式缓存正常，但AOT/InterpreterAndAOT模式下dotnet.wasm每次都从服务器拉取，且仅在Windows 10的IIS环境出现问题，大概率是IIS的静态内容处理配置未正确适配AOT构建的特性，或者缺少必要的IIS功能组件。下面是一步步的排查和解决思路：

1. 确认IIS已安装必要功能组件 #

Uno的默认web.config依赖IIS的几个核心功能才能正常处理缓存和压缩，而这些功能在Windows 10的IIS默认安装中可能未启用：

• 打开服务器管理器 → 添加角色和功能 → 定位到Web服务器（IIS） → Web服务器：
  • 在常见HTTP功能下，确保勾选：
    • 静态内容
    • 静态内容压缩（Gzip/Deflate）
  • 在应用程序开发下，确保勾选：
    • URL重写模块（Uno的web.config依赖该模块来分发压缩后的静态文件）

安装完成后重启IIS，再测试缓存情况。

2. 验证web.config的缓存规则是否生效 #

Uno模板默认的web.config包含针对.wasm文件的缓存和MIME类型配置，你可以检查这些配置是否在IIS中正常生效：

• 打开站点的web.config，确认存在以下配置段：

  <staticContent>
    <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="365.00:00:00" />
    <remove fileExtension=".wasm" />
    <mimeMap fileExtension=".wasm" mimeType="application/wasm" />
  </staticContent>
  

• 用浏览器开发者工具（F12 → 网络标签）加载页面，查看dotnet.wasm的响应头：
  • 确认存在Cache-Control: max-age=31536000（对应1年缓存）
  • 确认存在ETag或Last-Modified头（用于浏览器验证缓存有效性）
  • 如果这些头不存在，说明IIS未读取web.config的静态内容配置，可能需要检查站点的继承设置，或者手动在IIS管理器中配置静态内容缓存。

3. 检查AOT构建的压缩文件是否生成并被正确分发 #

AOT模式下的dotnet.wasm体积远大于Interpreter模式，Uno默认会生成压缩后的.gz版本来优化加载速度，但如果IIS无法分发这些压缩文件，不仅会导致加载慢，还可能间接影响缓存：

• 检查站点发布目录，确认存在dotnet.wasm.gz文件（如果没有，在项目csproj中添加<WasmShellGenerateCompressedFiles>true</WasmShellGenerateCompressedFiles>，重新发布）
• 查看浏览器请求dotnet.wasm的请求头，确认包含Accept-Encoding: gzip, deflate
• 查看响应头，确认存在Content-Encoding: gzip，且Content-Length远小于原文件大小
  • 如果没有这些头，说明URL重写模块未生效，或者web.config中的压缩规则未被正确执行，可尝试重新安装URL重写模块并重启IIS。

4. 验证文件权限和属性 #

有时候文件权限或时间戳异常也会导致缓存失效：

• 在IIS站点目录中，右键dotnet.wasm → 属性 → 安全，确保IIS_IUSRS组拥有读取权限
• 检查文件的修改时间，确认发布后时间戳已更新（如果时间戳异常，浏览器可能认为文件未变化，但IIS却返回新内容，导致缓存逻辑混乱）

5. 手动配置IIS输出缓存规则 #

如果以上步骤都没解决问题，可以尝试直接在IIS中添加针对.wasm文件的缓存规则：

• 打开IIS管理器 → 选中你的站点 → 双击输出缓存
• 点击添加缓存规则，设置：
  • 文件扩展名：.wasm
  • 用户模式缓存：勾选“启用缓存”，缓存持续时间设为365天
  • 验证：勾选“基于时间的失效”，确保浏览器在缓存有效期内直接读取本地缓存

通过以上步骤，应该能解决AOT模式下dotnet.wasm无法在IIS 10缓存的问题。

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