Blazor WASM通过Nginx配置Brotli压缩失效问题求助

问题根源 #

Nginx默认未将application/wasm（对应blazor.wasm）和application/octet-stream（对应Blazor DLL文件）纳入压缩匹配范围，且可能未启用预压缩文件的读取规则，导致即使已生成.gz/.br压缩文件，Nginx也不会返回给客户端。

具体修复步骤 #

1. 配置MIME类型（确保Nginx识别目标文件类型） #

在Nginx的server或location配置块中添加以下内容，让Nginx正确识别wasm和dll文件的MIME类型：

types {
    application/wasm wasm;
    application/octet-stream dll;
}

2. 启用预压缩并指定目标文件类型 #

同样在server或location配置块中，启用预压缩模块并指定需要匹配的文件类型：

# 启用Brotli预压缩（优先返回已生成的.br文件）
brotli_static on;
# 启用Gzip预压缩（作为Brotli的降级方案）
gzip_static on;

# 为目标文件类型开启压缩支持
gzip_types application/wasm application/octet-stream;
brotli_types application/wasm application/octet-stream;

3. Plesk环境下的配置注意事项 #

如果是通过Plesk管理服务器，请在域名 > Apache & Nginx设置 > 附加Nginx指令中添加上述配置，避免直接修改全局Nginx配置被Plesk自动覆盖。

4. 验证与重启 #

• 执行命令检查Nginx配置语法：

  nginx -t
  

• 配置无误后重启Nginx服务：

  systemctl restart nginx
  

验证 #

重新加载站点，检查blazor.wasm和DLL文件的响应头，应出现Content-Encoding: br（或gzip，如果客户端不支持Brotli）的标识。

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