如何调试Azure App Service中ASP.NET Core项目的Startup.cs（断点未命中）

嘿，这个场景我太熟悉了！当你通过Cloud Explorer附加调试器时，Azure上的应用早就完成启动流程了，Startup.cs里的代码已经执行完毕，断点自然不会被触发。不过有几个实用的办法能帮你在Startup里成功命中断点，我给你详细说说：

方法1：重启服务后快速附加调试器 #

这是最直接的临时方案，核心就是赶在Startup代码执行完之前连上调试器：

• 在Cloud Explorer或者Azure Portal中找到你的App Service，点击「重启」
• 立刻切回Visual Studio，通过Cloud Explorer选中你的App Service，点击「附加调试器」
• 如果一次没成功，多试几次；或者先把App Service停止，再启动，这样你有更多时间去附加调试器，成功率会更高。

方法2：让应用启动时等待调试器连接 #

通过配置App Service的环境变量，让应用启动时暂停，直到调试器附加：

• 打开Azure Portal，进入你的App Service，选择「配置」>「应用程序设置」
• 添加两个环境变量：
  • 名称：ASPNETCORE_ENVIRONMENT，值设为Development（如果本来就是开发环境可以跳过）
  • 名称：ASPNETCORE_DEBUG，值设为1
• 保存配置后重启App Service，此时应用会卡在启动阶段等待调试器。你回到Visual Studio附加调试器后，就能顺利命中Startup里的断点了。注意：调试完成后一定要把ASPNETCORE_DEBUG这个设置去掉，避免影响生产环境服务的正常启动！

方法3：发布时启用远程调试 #

如果需要频繁调试启动流程，这个方法更高效：

• 在Visual Studio的发布向导中，进入「设置」页面，找到「调试」选项，勾选「启用远程调试」，并选择和你的Visual Studio版本匹配的调试器版本
• 完成发布后，通过Visual Studio的「调试」>「附加到进程」，选择远程Azure上的应用进程，这样应用启动时就会和调试器关联，Startup里的断点就能正常触发了。

额外注意事项 #

确保你的ASP.NET Core 2.1项目启用了调试符号：在项目属性的「生成」页面中，确认「调试信息」设置为「完整」或「pdb-only」，否则调试器无法正确识别断点位置。

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