如何在IIS部署.NET 6.0 Blazor Web Assembly项目（依赖已装仍异常）

标准部署操作步骤 #

• 正确安装服务器依赖
  必须安装ASP.NET Core 6.0 Hosting Bundle（即Windows Server Hosting安装包），注意安装版本要和项目开发用的.NET 6补丁版本兼容；如果采用框架依赖模式发布，不需要单独安装SDK，仅需对应版本的ASP.NET Core运行时+Hosting Bundle即可，独立部署模式甚至不需要在服务器安装任何.NET运行时/SDK。安装完成后必须以管理员身份执行命令iisreset重启IIS，否则托管模块不会生效。
• 发布项目配置
  发布时注意以下配置项：
  • 部署模式选「框架依赖」时，目标运行时必须和服务器架构匹配：64位系统选win-x64、32位选win-x86，如果选x86运行时后续必须在IIS应用池开启32位应用支持
  • 勾选「发布前删除所有现有文件」，避免旧版本的dll、静态缓存文件残留引发冲突
  • 发布完成后确认输出目录存在web.config配置文件和wwwroot文件夹，二者为部署核心文件，不可遗漏
• IIS站点基础配置
  • 新建独立应用程序池，.NET CLR版本选择无托管代码，托管管道模式设为集成
  • 应用池高级设置中，若发布选x86运行时则将「启用32位应用程序」设为True，x64运行时保持False即可
  • 新建网站时，物理路径指向发布输出的根目录（即存放web.config的目录层级，不要直接指向内部的wwwroot文件夹）
  • 给站点物理路径分配权限：为IIS_IUSRS用户组开放读取、列出目录内容、执行权限
• 验证托管模块
  打开IIS根节点的「模块」功能列表，确认存在AspNetCoreModuleV2模块，若不存在说明Hosting Bundle安装异常，修复安装后再次执行iisreset即可。

故障排查方案 #

• 先获取详细错误信息
  不要仅凭默认的500/403模糊报错排查，先临时修改站点web.config，在<aspNetCore>节点下添加如下配置，开启开发环境错误页，直接访问站点即可看到精准的错误堆栈：

  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
  </environmentVariables>
  

• 运行时架构/版本不匹配排查
  当前安装的是X86版本的.NET SDK，若发布时选择x64框架依赖模式，会直接触发找不到运行时的错误。可在服务器命令行执行dotnet --info，查看已安装的运行时版本、架构列表，确认和发布时选择的目标运行时完全匹配。
• 静态资源加载异常排查
  Blazor WASM的核心运行逻辑依赖静态文件加载，首先确认服务器IIS已经安装「静态内容」角色服务：打开服务器管理器-添加角色和功能-Web服务器(IIS)-常见HTTP功能，勾选「静态内容」完成安装。若出现dll/wasm等文件404的问题，在web.config中补全MIME类型配置：

  <staticContent>
    <remove fileExtension=".blat" />
    <remove fileExtension=".dat" />
    <remove fileExtension=".dll" />
    <remove fileExtension=".json" />
    <remove fileExtension=".wasm" />
    <remove fileExtension=".woff" />
    <remove fileExtension=".woff2" />
    <mimeMap fileExtension=".blat" mimeType="application/octet-stream" />
    <mimeMap fileExtension=".dll" mimeType="application/octet-stream" />
    <mimeMap fileExtension=".dat" mimeType="application/octet-stream" />
    <mimeMap fileExtension=".json" mimeType="application/json" />
    <mimeMap fileExtension=".wasm" mimeType="application/wasm" />
    <mimeMap fileExtension=".woff" mimeType="font/woff" />
    <mimeMap fileExtension=".woff2" mimeType="font/woff2" />
  </staticContent>
  

• 路由404问题排查
  Blazor WASM为客户端路由，需要URL重写规则将所有非文件/非目录的请求回退到index.html，否则刷新子路由页面会报404。确认web.config中存在如下重写规则：

  <rewrite>
    <rules>
      <rule name="BlazorRoutingFallback">
        <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="index.html" />
      </rule>
    </rules>
  </rewrite>
  

• 配置文件权限/格式错误排查
  若出现500.19错误，首先检查web.config的XML格式是否正确，有没有节点未闭合、属性值未加引号的问题；其次确认站点目录的权限配置正确，不要直接给Everyone权限凑合用，遵循最小权限原则分配IIS相关账户权限即可。

排查完成后记得将web.config中的ASPNETCORE_ENVIRONMENT值改回Production，避免泄露应用敏感配置、堆栈信息。

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