Windows 10 IIS部署ASP.Net Core Web API返回500错误如何解决？

1. 启用详细错误日志定位具体问题 #

默认IIS只会返回通用500错误，首先要开启详细报错信息：

• 打开IIS管理器选中testpolicy站点，双击「错误页」，点击右侧「编辑功能设置」，选择「详细错误」后保存
• 也可以直接修改站点根目录的web.config文件，在<system.webServer>节点下增加配置：

<httpErrors errorMode="Detailed" />
<aspNetCore stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" />

注意：需要先在站点物理路径下手动创建logs文件夹，重启站点后再次访问接口，既可以在浏览器直接看到具体报错内容，也可以在logs文件夹下查看ASP.NET Core的运行日志

2. 检查基础配置项 #

（1）验证Hosting Bundle版本与安装状态 #

• 你开发用的.NET Core版本必须和安装的ASP.NET Core Hosting Bundle版本完全一致，比如项目用.NET 5就不能仅安装.NET 6的Hosting Bundle
• 安装完Hosting Bundle后必须执行iisreset命令重启IIS，否则配置不会生效

（2）检查文件夹权限 #

站点对应的应用程序池身份默认是IIS AppPool\testpolicy，需要给物理路径inetpub/wwwroot/testpolicy添加该用户的权限：

• 右键文件夹→属性→安全→编辑→添加，输入IIS AppPool\testpolicy（替换为你实际的应用程序池名称），检查名称确认后，赋予「读取和执行、列出文件夹内容、读取」权限

（3）验证端口占用 #

打开命令提示符执行netstat -ano | findstr "8061"，确认8061端口没有被其他进程占用，如有占用可修改站点绑定端口或停止占用进程。

3. 验证程序本身运行正常 #

• 检查发布目录下的文件是否完整，必须包含web.config、项目dll、appsettings.json等核心文件
• 在站点目录下打开cmd，执行dotnet 你的项目名称.dll，如果能正常启动说明程序本身无问题，故障出在IIS联动配置上；如果执行报错则根据提示修复程序问题，比如缺少依赖、配置文件错误等。

4. 检查路由配置 #

你的控制器路由规则是api/[controller]，控制器名称PolicyController对应的路由http://localhost:8061/api/policy是正确的，但需要确认控制器内存在可访问的Action，比如：

[HttpGet]
public IActionResult Test()
{
    return Ok("部署成功");
}

如果控制器内没有任何绑定了请求方法的Action，访问路由也会返回500或404错误

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