在Azure App Service中发布ASP.NET Core 5 Web API应用遇到的问题

通用排查步骤 #

• 核对运行环境匹配度：确认服务器安装的.NET/.NET Core 运行时版本与项目编译使用的 SDK 版本完全一致，优先选择「独立部署」模式发布，避免服务器缺少对应依赖导致启动失败。
• 校验目录权限配置：确认发布目录的读写、执行权限已分配给 Web 服务对应的运行账户，例如 IIS 场景下的 IIS_IUSRS 用户组、Nginx 反向代理场景下的 www-data 用户，避免程序读取配置、写入日志时报权限错误。
• 检查生产环境配置：核对发布后生成的 appsettings.json、web.config（IIS 部署场景）配置内容，重点确认数据库连接字符串、第三方服务地址、跨域规则、端口监听配置符合生产环境要求，不存在本地调试配置残留。
• 捕获完整异常信息：在项目启动文件中添加全局异常捕获中间件，将异常堆栈信息输出到控制台或者本地日志文件，也可以直接在服务器命令行进入发布目录，执行 dotnet 你的项目主程序名.dll 命令启动程序，查看控制台输出的具体报错内容。
• 排查端口占用冲突：确认程序配置的监听端口没有被服务器其他进程占用，IIS 部署场景下额外确认站点绑定的域名、端口没有和服务器上其他站点冲突。

常见问题快速修复方案 #

• IIS 部署场景下如果出现 502.5 或者 500 类启动错误，优先安装对应版本的 ASP.NET Core Hosting Bundle 托管捆绑包，安装完成后重启 IIS 再重试访问。
• 不要手动拆分拷贝发布文件，使用 Visual Studio 自带发布工具或者 dotnet publish 命令执行全量发布，避免遗漏依赖文件。
• 如果诊断工具提示资源占用异常，检查程序是否存在未释放的数据库连接、未做限流的高频接口、内存泄漏类问题，可以先重启站点临时恢复访问，再针对具体接口做性能压测定位问题。

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