使用ASP.NET Core Web API和EF Core部署IIS时HTTP 500错误如何排查？

1. 先抓具体错误信息 #

IIS默认会隐藏详细错误，先让API暴露真实错误：

• 修改appsettings.json，添加开启详细错误的配置：

  "DetailedErrors": true,
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Debug"
    }
  }
  

• 在Program.cs临时启用开发异常页（排查完记得关闭）：

  var app = builder.Build();
  
  // 临时开启，生产环境务必删除
  app.UseDeveloperExceptionPage();
  
  // ...其他中间件配置
  app.Run();
  

• 查看IIS自带日志，默认路径为C:\inetpub\logs\LogFiles\W3SVC{站点ID}，里面会记录请求的具体错误代码和原因。

2. 验证数据库连接（服务器端） #

本地能用的凭据，服务器可能因为网络/权限问题连不上：

• 登录IIS服务器，打开「ODBC数据源(64位)」，新建SQL Server数据源，用你的连接信息测试，看能否成功访问目标数据库。
• 检查SQL Server防火墙：确认是否允许IIS服务器的IP访问1433端口（默认SQL端口）。
• 打开SQL Server配置管理器，检查「SQL Server网络配置」里的TCP/IP是否已启用。

3. 应用程序池配置检查 #

• 确认应用程序池的.NET CLR版本设为无托管代码（ASP.NET Core不需要传统.NET托管环境）。
• 检查应用程序池身份：如果用内置账户（比如ApplicationPoolIdentity），要确保该账户有网站目录的读写权限，以及数据库访问权限（若用Windows身份验证连库）。
• 查看应用程序池状态，确认没有崩溃或停止。

4. 部署文件与配置校验 #

• 对比本地发布文件夹和服务器上的文件，确保bin目录的DLL、appsettings.json、web.config等文件完整上传。
• 检查web.config的AspNetCoreModule配置，示例正确格式：

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <location path="." inheritInChildApplications="false">
      <system.webServer>
        <handlers>
          <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
        </handlers>
        <aspNetCore processPath="dotnet" arguments=".\YourApi.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
      </system.webServer>
    </location>
  </configuration>
  

• 开启stdout日志：把stdoutLogEnabled设为true，手动创建logs目录并给应用程序池账户写权限，日志会记录进程启动时的报错。

5. 权限排查 #

• 网站根目录：给应用程序池对应的账户添加读取权限，若API有文件写入需求，再加写入权限。
• 数据库权限：确认服务器端SQL实例中，你的数据库用户是否被授予目标表的SELECT权限（本地权限配置和服务器可能不一致）。

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