在Windows Server 2016运行ASP.NET Core网站遇HTTP 502.3及SDK提示问题

看到你遇到的502.3错误和SDK提示，其实这个SDK提示大概率是个误导——你安装的托管捆绑包已经包含运行所需的Runtime，问题通常出在IIS配置、模块注册或者Runtime识别上。下面一步步帮你排查：

1. 确认ASP.NET Core模块正确安装并注册到IIS #

• 打开IIS管理器，点击服务器节点，选择模块，检查是否存在AspNetCoreModule（ASP.NET Core 2.x版本用这个，3.x+是AspNetCoreModuleV2）。
• 如果没找到，重新运行你下载的.NET Core 2.1托管捆绑包安装程序，选择修复选项，确保模块正确注册到IIS。

2. 检查应用池配置 #

• 你的网站对应的应用池，必须设置为无托管代码：右键应用池 → 高级设置 → 常规 → 托管管道模式选择集成，.NET CLR版本选择无托管代码。
• 这一步很关键，因为ASP.NET Core是独立运行的进程，IIS只是作为反向代理，不需要加载.NET Framework托管代码。

3. 验证web.config的核心配置 #

确保你的web.config里的AspNetCore部分配置正确，应该类似这样：

<system.webServer>
  <handlers>
    <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
  </handlers>
  <aspNetCore processPath="dotnet" arguments=".\YourProjectName.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="InProcess" />
</system.webServer>

• 注意hostingModel：ASP.NET Core 2.1从2.1.13版本开始支持InProcess模式，如果你不确定版本兼容性，可以改成OutOfProcess试试。
• 确认arguments里的dll文件名和你发布的dll完全一致，路径没有拼写错误。

4. 检查.NET Core Runtime是否正确安装 #

• 打开服务器的命令提示符，运行dotnet --info，查看输出里的Runtime Environment部分，是否包含.NET Core 2.1.x的Runtime（注意是Runtime，不是SDK）。
• 如果没有找到2.1的Runtime，重新下载安装.NET Core 2.1的托管捆绑包，安装后再运行dotnet --info确认。

5. 权限排查 #

• 应用池的身份（默认是ApplicationPoolIdentity）需要有网站目录的读取和执行权限，以及访问dotnet.exe所在目录（通常是C:\Program Files\dotnet）的权限。
• 右键网站目录 → 属性 → 安全 → 添加IIS AppPool\你的应用池名称，赋予读取和执行权限。

6. 查看更详细的错误日志 #

• 除了web.config的stdout日志，打开事件查看器 → Windows日志 → 应用程序，查看有没有和ASP.NET Core相关的错误事件，里面会有更具体的失败原因，比如dll找不到、权限不足等。

按照上面的步骤逐一排查，应该能解决你的502.3错误。

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