如何正确部署Blazor Wasm静态文件至服务器网站根目录？

一、正确的文件上传操作 #

发布独立Blazor Wasm后，你需要将**wwwroot文件夹内的所有内容**，以及同级的web.config文件一同上传到服务器的网站根目录，不能只上传wwwroot里的内容。

web.config是IIS服务器的核心配置文件，它负责处理Blazor Wasm的路由重写——因为Blazor Wasm是单页应用，所有路由请求都需要指向index.html，缺少这个文件会导致路由解析失败，进而出现你遇到的加载错误。

二、不同服务器的补充配置 #

如果你的服务器不是IIS，需要针对对应服务器配置路由重写规则：

• Nginx：在站点配置文件中添加规则，将所有请求转发到index.html：

  location / {
      try_files $uri $uri/ /index.html;
  }
  

• Apache：在网站根目录创建.htaccess文件，添加以下内容：

  FallbackResource /index.html
  

同时要确保服务器已启用静态文件服务，能正常加载wwwroot中的css、js、_framework等资源。

三、官方部署核心要求 #

官方文档针对独立Blazor Wasm自有服务器部署的核心要点：

1. 发布时选择「独立」模式，确保生成对应服务器的配置文件（如IIS的web.config）。
2. 完整上传所有发布输出文件，不要遗漏配置文件。
3. 根据服务器类型配置路由重写，保证单页应用路由正常工作。
4. 推荐服务器支持HTTP/2，提升应用加载性能。

内容的提问来源于stack exchange，提问作者Talon Van Vuuren