部署到IIS的Blazor站点所有URL均返回空白HTML页面

• 检查物理路径权限
  确保IIS应用池的身份（默认是AppPoolIdentity）对站点根目录及子文件夹拥有读取和执行权限，重点确认wwwroot、bin目录的权限。权限不足会导致ASP.NET Core无法加载必要的资源或程序集，进而返回空页面。

• 启用ASP.NET Core stdout日志
  修改站点根目录下的web.config，开启标准输出日志以捕获应用启动或运行时的错误：

  <aspNetCore processPath="dotnet" arguments=".\YourApplication.dll" 
              stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" 
              hostingModel="inprocess" />
  

  手动创建logs文件夹（避免日志写入失败），重启站点后访问页面，查看生成的日志文件——这里通常会记录IIS日志和事件查看器没有捕获到的应用级错误。

• 验证.NET运行时与模块

  1. 打开命令行执行dotnet --list-runtimes，确认服务器上存在Microsoft.AspNetCore.App 6.0.22运行时版本，确保与站点编译时依赖的版本一致。
  2. 在IIS管理器的站点“模块”列表中，确认存在AspNetCoreModuleV2模块（托管捆绑包默认包含，若缺失可重新安装.NET 6托管捆绑包）。
  3. 确保应用池的“.NET CLR版本”设置为无托管代码。

• 直接运行应用测试
  在服务器上打开命令行，进入站点物理路径，执行dotnet YourApplication.dll启动应用，然后通过http://localhost:5000（或应用配置的端口）访问。

  • 如果此方式能正常显示页面，说明问题出在IIS配置或模块上，重点检查AspNetCoreModuleV2的注册和应用池设置。
  • 如果依然返回空白页面，查看命令行输出的错误信息，这通常是应用本身的启动问题（比如依赖缺失、配置文件错误）。

• 检查应用启动与路由逻辑

  1. 查看Program.cs中的中间件配置，确认没有错误的全局异常处理逻辑导致返回空页面。
  2. 检查Blazor的路由配置：确认FallbackRoute没有被错误配置为返回空组件，或者自定义的路由 fallback 逻辑没有覆盖所有请求并返回空内容。

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