无ASP.NET托管的Blazor Client如何配置SPA的web.config无需使用IIS

纯独立Blazor WASM（无后端.NET主机、无关联API）的web.config仅用于处理静态服务器的文件识别和路由规则，无需任何服务端托管相关配置。

可用的完整web.config模板 #

将以下内容保存为web.config文件，放在Blazor WASM项目的wwwroot根目录下即可，发布时会自动打包到输出目录：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <!-- 注册Blazor WASM运行所需的文件MIME类型 -->
    <staticContent>
      <remove fileExtension=".dll" />
      <mimeMap fileExtension=".dll" mimeType="application/octet-stream" />
      <remove fileExtension=".wasm" />
      <mimeMap fileExtension=".wasm" mimeType="application/wasm" />
      <remove fileExtension=".blat" />
      <mimeMap fileExtension=".blat" mimeType="application/octet-stream" />
      <remove fileExtension=".dat" />
      <mimeMap fileExtension=".dat" mimeType="application/octet-stream" />
      <remove fileExtension=".json" />
      <mimeMap fileExtension=".json" mimeType="application/json" />
    </staticContent>
    <!-- 配置客户端路由回退规则，解决直接访问子路由报404的问题 -->
    <rewrite>
      <rules>
        <rule name="Blazor WASM 路由适配" stopProcessing="true">
          <match url=".*" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="/" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

配置说明 #

• 本地开发调试时不需要手动配置web.config，只有将发布后的静态文件部署到IIS等静态服务器时才需要用到该配置
• MIME类型配置用于修正静态服务器对Blazor WASM专用文件格式的识别，避免加载资源时报404错误
• 路由回退规则用于处理Blazor客户端路由，当用户直接访问/counter这类非根路径的路由时，会自动回退到index.html交由Blazor客户端处理路由，避免出现404
• 所有配置均无服务端托管逻辑，完全适配纯客户端学习Blazor WASM的场景

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