.NET Core项目本地运行报HTTP Error 502.5错误，求排查建议

兄弟，这个502.5进程失败的坑我之前踩过好多次，给你整理几个最实用的排查方向，按顺序试基本能解决：

• 先确认.NET Core运行时版本是否匹配
  许久未维护的项目大概率用的是老版本的.NET Core，新电脑可能没装对应runtime。右键项目→属性→应用，看目标框架（比如.NET Core 2.2），然后去控制面板→程序和功能里核对有没有装这个版本的ASP.NET Core Runtime。没装的话直接去微软官网下载对应版本就行，注意是Runtime不是SDK（当然装SDK也能跑）。

• 开启详细日志抓具体错误
  Visual Studio默认不会显示进程失败的细节，你得手动开日志。打开项目根目录的web.config，找到<aspNetCore>节点，把stdoutLogEnabled改成true，stdoutLogFile设成.\logs\stdout（路径随便，只要能写就行），然后重新跑项目。之后去指定的日志目录看生成的文件，里面会明明白白告诉你是依赖丢了、配置错了还是啥其他问题，这是最直接的排查手段。

• 还原NuGet依赖，检查本地引用
  克隆下来的项目大概率没自动还原NuGet包。右键解决方案→“还原NuGet包”，或者打开Package Manager Console跑Update-Package -reinstall强制重装所有依赖。另外要注意，有些项目可能引用了本地的dll（不是NuGet包的），新电脑上没有的话也会崩，这种情况得检查引用路径，把缺失的dll复制到输出目录或者重新添加引用。

• 检查端口是否被占用
  项目启动用的端口可能被其他程序占了。去项目属性→调试里看应用URL（比如http://localhost:5000），然后开命令提示符跑netstat -ano | findstr :5000，看有没有对应的PID，找到后去任务管理器结束那个进程，再重启项目就行。

• 核对环境变量和配置文件
  旧项目可能依赖本地的环境变量，或者appsettings.json里有本地配置（比如数据库连接串、密钥），新电脑上没有这些就会启动失败。打开appsettings.json检查配置项，另外看看有没有appsettings.Development.json——这个文件通常会被.gitignore忽略，克隆的时候不会下来，得手动从旧电脑拷或者重新配置。

• 清理IIS Express缓存（如果用它运行）
  IIS Express有时候会抽风，缓存的配置出问题。你可以删除%USERPROFILE%\Documents\IISExpress这个文件夹，然后重启Visual Studio，重新生成项目再跑。也可以把启动方式改成“控制台应用”试试，能启动的话就是IIS Express的问题。

• 确认启动项和程序入口没问题
  右键解决方案→“设置启动项目”，确保选中的是你的Web应用项目。另外检查Program.cs里的CreateWebHostBuilder（或者CreateHostBuilder，看.NET Core版本）方法，有没有配置错误的Kestrel选项或者中间件，比如有没有写错监听地址之类的。

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