Blazor部署到Windows Server 2012 R2 IIS运行报500 Internal Server Error求助

1. 提取IIS详细错误日志定位根因 #

• 让服务器管理员导出对应站点的IIS日志，默认路径是C:\inetpub\logs\LogFiles\下对应站点ID的文件夹，重点查找状态码500的请求对应的子状态码（比如500.19是配置错误、500.21是模块未注册）和Win32错误码，可直接定位问题类型
• 权限允许的情况下，临时在站点的web.config里把httpErrors的errorMode改为Detailed，远程访问报错资源就能看到完整的详细错误页，排查完记得改回RemoteOnly避免安全风险，无需在服务器本地用IE操作

2. 验证Windows Hosting Bundle安装有效性 #

• 检查服务器「程序和功能」里是否安装了和开发环境SDK版本完全匹配的对应.NET版本Windows Hosting Bundle，版本不匹配是模块加载失败的高频原因
• 打开IIS的「模块」功能，确认是否存在AspNetCoreModuleV2模块，如果缺失就是Hosting Bundle安装异常，需要先卸载已装的版本，重启服务器后再重新安装对应版本的Hosting Bundle

3. 检查站点配置与权限 #

• 确认站点的应用程序池.NET CLR版本设置为无托管代码，Blazor WASM托管模式需要无托管的应用程序池运行ASP.NET Core模块
• 检查站点根目录的权限，确保应用程序池的标识用户（默认是IIS AppPool\你的应用池名）对根目录有读取和执行权限
• 对比本地正常运行站点的web.config，确认服务器站点web.config的<handlers>节点下已正确注册AspNetCoreModuleV2处理程序

4. MIME类型与静态资源配置验证 #

• 打开IIS站点的「MIME类型」功能，确认已添加WASM相关的MIME类型：
  • .wasm 对应 application/wasm
  • .json 对应 application/json
  • .dll 对应 application/octet-stream
    缺失对应配置会导致静态资源请求触发500错误
• 确认没有IIS全局规则或者站点web.config规则拦截.dll、.wasm后缀的请求，默认IIS会禁止.dll文件的静态访问，Blazor部署需要放开该限制

5. URL Rewrite规则验证 #

• 确认URL Rewrite组件安装后，站点根目录web.config里已正确配置Blazor WASM的路由回退规则，所有非静态资源的请求都重定向到index.html
• 排查服务器全局URL Rewrite规则是否和站点规则冲突，导致资源请求被错误重定向或者拦截

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