Blazor WebAssembly部署至IIS本地主机失败求助

1. 启用IIS静态文件功能 #

• 打开「控制面板 > 程序 > 启用或关闭Windows功能」
• 勾选「Internet Information Services > 万维网服务 > 常见HTTP功能 > 静态文件」，重启IIS。

2. 修复Web.config的MIME类型配置 #

发布后的站点根目录需确保Web.config包含正确的MIME映射，避免资源识别失败：

<system.webServer>
  <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=".dat" mimeType="application/octet-stream" />
    <mimeMap fileExtension=".dll" 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>
  <httpErrors errorMode="Detailed" />
</system.webServer>

若Web.config缺失，直接创建并添加上述内容。

3. 调整应用程序池设置 #

• 打开IIS管理器，找到对应站点的应用程序池
• 将**.NET CLR版本**设置为「无托管代码」（Blazor WASM无需.NET后端托管）
• 确认应用程序池标识拥有站点目录的读写权限。

4. 配置发布目录权限 #

• 右键站点发布文件夹，选择「属性 > 安全」
• 为IIS_IUSRS和IUSR用户添加「读取和执行」「列出文件夹内容」「读取」权限。

5. 清除缓存并排查资源加载错误 #

• 按Ctrl+Shift+R强制刷新浏览器，清除本地缓存
• 打开浏览器开发者工具（F12），查看「网络」标签，定位加载失败的资源（如404/500状态），针对性修复。

6. 重新发布项目 #

• 发布时选择与项目匹配的目标框架，勾选「删除目标中的现有文件」选项
• 确认发布模式为Release，避免调试文件干扰。

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