升级Application Insights 2.5后Azure App Services无法启动咨询

我来帮你捋一捋这个问题——升级Application Insights到2.5版本后Azure App Service启动失败，这种情况在混合了ASP.NET Core和传统Framework应用的场景里确实容易踩坑，咱们一步步来排查解决：

首先，2.5版本的AI SDK在兼容性上有几个需要重点关注的点，尤其是针对你的混合框架项目：

• ASP.NET Core 2.0属于较早期的版本，2.5版本SDK新增的实时流功能可能引入了Core 2.0不支持的API或依赖项，导致启动冲突
• 完整框架的ASP.NET 4应用，升级后可能和原有web.config中的配置节点（比如遥测初始化器、模块注册）出现版本冲突
• VSTS构建发布过程中，可能没有正确打包SDK所需的全部依赖组件，导致运行时出现程序集缺失

1. 先拿到具体的启动错误日志 #

这是排查的关键，别盲目试错：

• 登录Azure门户，进入你的App Service，打开诊断和解决问题 > 日志流，或者直接进入高级工具(Kudu)，查看日志下的事件查看器日志或站点扩展日志
• 重点找带Application Insights、Failed to start、Assembly not found关键词的错误，比如是否提示找不到特定版本的Microsoft.ApplicationInsights.AspNetCore程序集

2. 针对ASP.NET Core 2.0应用的检查 #

• 确认项目文件中所有AI相关包版本一致：确保Microsoft.ApplicationInsights.AspNetCore、Microsoft.ApplicationInsights等包都是2.5.x版本，不要混合不同版本
• 检查Startup.cs的初始化代码：2.5版本SDK在Core 2.0中的初始化逻辑有没有变化？对比同版本SDK针对Core 2.0的官方示例，确认services.AddApplicationInsightsTelemetry(Configuration)这类调用是否需要调整
• 临时回退测试：把Core应用的AI SDK版本回退到之前能正常运行的版本，看是否能启动，以此确认是不是2.5和Core 2.0的兼容性问题

3. 针对ASP.NET 4完整框架应用的检查 #

• 打开web.config，核对AI相关配置：
  • 确认<modules>里的Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule版本是否和SDK匹配，有没有旧版本残留
  • 检查<appSettings>中的ApplicationInsights:InstrumentationKey是否正确，没有被发布过程覆盖
  • 确保绑定重定向配置正确，比如：

    <dependentAssembly>
        <assemblyIdentity name="Microsoft.ApplicationInsights" publicKeyToken="31bf3856ad364e35" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-2.5.0.0" newVersion="2.5.0.0" />
    </dependentAssembly>
    

• 检查NuGet包引用：确认Microsoft.ApplicationInsights.Web等ASP.NET专属AI包都是2.5.x版本，没有遗漏或版本不匹配的情况

4. VSTS构建发布环节的检查 #

• 确认构建过程中启用了还原NuGet包步骤，并且禁用了缓存（避免拉取旧版本依赖）
• 检查发布配置，确保勾选了发布所有依赖项，保证AI相关的所有dll都被打包到发布包中
• 本地预发布测试：在本地把项目发布到文件夹，检查bin目录下的AI相关dll版本是否都是2.5.x，有没有缺失的组件

如果需要快速恢复服务，可以先把所有AI包回退到之前稳定的版本，确认服务正常启动后，再逐个应用升级测试，避免一次性全量升级导致批量故障

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