ASP.NET Core搭配ReactJS应用部署到IIS后访问空白页问题求助

排查方向与解决步骤 #

• 确认React生产构建产物完整性
  检查发布后的站点根目录下是否存在ClientApp/build文件夹，确保文件夹内包含index.html以及打包后的js、css等静态资源。如果缺失，先在ClientApp目录下执行npm run build完成生产构建，再重新发布应用。

• 开启后端日志排查启动错误
  将web.config中的stdoutLogEnabled属性改为true，手动在站点根目录创建logs文件夹，给IIS应用池运行身份（默认是IIS_IUSRS组）授予该文件夹的读写权限。重启站点后再次访问，查看logs目录下的输出日志，排查是否存在数据库连接失败、配置读取错误等后端启动异常。

• 放开SPA路由回退配置
  取消Startup.cs中endpoints.MapFallbackToController("Index", "Home")这行代码的注释。生产环境下所有未匹配到后端接口的请求都会回退返回React的index.html，交由前端路由接管，避免直接访问前端路由时出现404空白页。

• 修正静态资源请求路径
  如果站点部署在IIS的虚拟目录下而非根站点，需要在ClientApp/package.json中添加配置"homepage": "/你的虚拟目录别名/"，重新打包后发布，避免静态资源从站点根路径请求导致404加载失败。

• 检查IIS权限与环境变量配置

1. 给站点根目录授予IIS_IUSRS组的读取、执行权限，确保静态资源可正常访问
2. 在web.config的aspNetCore节点中添加环境变量配置，强制指定运行环境为Production，避免生产环境尝试启动React开发服务器导致卡住：

<aspNetCore processPath=".\ApplicationXYZ.exe" 
    stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" 
    hostingModel="inprocess">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
  </environmentVariables>
</aspNetCore>

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