React+.NET MVC项目IIS部署后持续返回500错误排查求助

排查步骤 #

• 开启IIS详细错误提示：在IIS管理器中找到对应站点，打开「错误页」功能，编辑500错误的响应规则，选择「详细错误」，获取具体错误详情，替代默认的泛用500提示。
• 查看应用程序日志：打开服务器的「事件查看器」，展开「Windows日志」→「应用程序」，筛选来源为ASP.NET或.NET Runtime的日志，从中提取异常堆栈信息，定位具体出错点。
• 验证站点权限：确保IIS应用程序池的身份（如AppPoolIdentity）对项目根目录、bin文件夹、wwwroot静态资源目录拥有读取和执行权限；若涉及数据库，还要确认该身份具备数据库访问权限。
• 检查配置文件有效性：核对web.config和appsettings.json的配置项，比如数据库连接字符串、第三方服务密钥是否适配服务器生产环境；同时查看web.config中的自定义错误配置，避免其屏蔽详细错误信息。
• 单独测试后端接口：用Postman或curl直接调用服务器上的.NET接口，排除前端静态文件的干扰，确认错误是否来自后端逻辑。
• 确认.NET环境兼容性：检查服务器是否安装了项目依赖的.NET SDK/Runtime版本，同时确保应用程序池的「.NET CLR版本」配置正确（.NET Core/.NET 5+项目需选择「无托管代码」）。

常见错误原因 #

• 权限不足：应用程序池身份无项目文件读取权限，或无数据库访问权限（比如用Windows身份验证连接数据库时，池身份未被授权）。
• 配置不匹配：本地开发环境的配置（如数据库连接串）未替换为服务器生产环境配置，导致服务初始化失败。
• .NET Runtime缺失：服务器未安装项目依赖的.NET版本，或应用程序池CLR版本配置错误（比如把.NET Core项目配置成.NET Framework的CLR版本）。
• 静态文件配置问题：IIS未启用「静态文件」功能，或React打包后的静态资源路径配置错误，导致请求静态文件时触发服务器错误。
• 未捕获异常：后端代码存在未处理的异常，本地调试模式下被捕获，但生产环境未处理，直接返回500错误，需通过应用日志定位具体代码位置。
• 前端路由重写缺失：React使用前端路由时，页面刷新会触发服务器请求对应路径，若未配置URL重写规则，服务器找不到对应控制器/Action可能引发500错误，需在web.config中添加重写规则：

<system.webServer>
  <rewrite>
    <rules>
      <rule name="React Routes" stopProcessing="true">
        <match url=".*" />
        <conditions logicalGrouping="MatchAll">
          <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
          <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          <add input="{REQUEST_URI}" pattern="^/(api)" negate="true" />
        </conditions>
        <action type="Rewrite" url="/index.html" />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

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