Bot Framework V4部署Azure报500内部服务器错误（本地Ngrok运行正常）

从错误信息来看是Azure App Service上的AspNetCoreModuleV2在执行.NET应用时抛出了未处理异常，本地Ngrok运行正常说明核心逻辑无硬伤，按以下优先级排查即可定位问题：

1. 应用代码/配置错误排查（概率最高） #

• 启用Azure App Service的详细日志：进入App Service面板→「监视」→「应用服务日志」，开启应用程序日志（文件系统），日志级别调整为Verbose，同时开启「详细错误日志」和「失败请求跟踪」。复现一次请求后，可直接在日志流看到应用抛出的完整异常栈，也可以到Kudu控制台的C:\home\LogFiles\Application目录下查看日志文件。
• 核对Bot核心配置：确认App Service的应用配置中，MicrosoftAppId、MicrosoftAppPassword两个参数的值和Azure Bot服务中分配的凭证完全一致，本地开发环境通常会跳过这两个参数的校验，部署到Azure后凭证不匹配会直接抛出未捕获异常。
• 检查代码依赖项：确认代码中没有依赖本地环境的资源，比如本地文件路径、本地数据库、内网可访问的接口等，这类资源在Azure环境无法访问会直接触发服务崩溃。

2. 部署/运行环境排查 #

• 检查CI/CD构建产物：打开Github Action的构建日志，确认构建使用的.NET SDK版本和你本地开发版本完全一致，同时确认构建产物中包含web.config文件，且文件中aspNetCore节点的进程路径配置正确。
• 手动启动应用验证：进入App Service的Kudu控制台→「调试控制台」→「CMD」，切换到C:\home\site\wwwroot目录，执行命令dotnet 你的应用入口文件名.dll，如果应用启动过程中有依赖缺失、配置错误会直接在控制台打印错误信息。
• 核对运行栈配置：进入App Service面板→「配置」→「通用设置」，确认运行时堆栈选择的.NET版本和你的应用目标版本匹配，不要误选为.NET Framework版本。

3. 权限/路由配置排查 #

• 避免权限问题：可以在App Service的应用配置中新增参数WEBSITE_RUN_FROM_PACKAGE，值设为1，使用只读包运行模式，跳过NTFS权限校验的问题。
• 确认机器人端点配置：检查Azure Bot服务的「配置」页中的「消息端点」，必须和你App Service的访问地址加/api/messages后缀完全匹配，路径错误会导致请求无法被正确路由。

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