Visual Studio添加Application Insights向导失败，依赖版本不兼容求助

你遇到的是典型的NuGet包版本依赖不兼容问题，在家环境中Visual Studio向导自动拉取的组件版本和办公室不一致，导致了冲突。下面是几个经过验证的解决方法：

问题详情 #

你在家使用Visual Studio向导给基于.NET Framework 4.5.2的Web API项目添加Application Insights时失败，报错如下：

--------------------------- Microsoft Visual Studio ---------------------------
Could not add Application Insights to project. Failed to install package: Microsoft.ApplicationInsights.Web with error: Unable to resolve dependencies. 'Microsoft.ApplicationInsights 2.5.0' is not compatible with 'Microsoft.ApplicationInsights.DependencyCollector 2.4.1 constraint: Microsoft.ApplicationInsights (= 2.4.0)', 'Microsoft.ApplicationInsights.PerfCounterCollector 2.4.1 constraint: Microsoft.ApplicationInsights (= 2.4.0)', 'Microsoft.ApplicationInsights.Web 2.4.1 constraint: Microsoft.ApplicationInsights (= 2.4.0)', 'Microsoft.ApplicationInsights.WindowsServer 2.4.1 constraint: Microsoft.ApplicationInsights (= 2.4.0)', 'Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel 2.4.0 constraint: Microsoft.ApplicationInsights (= 2.4.0)'.

即使安装了Application Insights Status Monitor也未能解决，且你仅通过向导操作，未手动安装其他相关组件。

解决方法 #

1. 彻底清理并重装统一版本的NuGet包 #

这是最直接有效的方法，通过NuGet包管理器控制台强制卸载冲突包，再安装一致版本：

• 打开工具 → NuGet包管理器 → 包管理器控制台
• 执行以下命令卸载所有相关包：

  Uninstall-Package Microsoft.ApplicationInsights -Force
  Uninstall-Package Microsoft.ApplicationInsights.Web -Force
  Uninstall-Package Microsoft.ApplicationInsights.DependencyCollector -Force
  Uninstall-Package Microsoft.ApplicationInsights.PerfCounterCollector -Force
  Uninstall-Package Microsoft.ApplicationInsights.WindowsServer -Force
  Uninstall-Package Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel -Force
  

• 选择一个稳定的兼容版本（比如2.4.0，或升级到更高的统一版本如2.21.0），执行安装命令：

  Install-Package Microsoft.ApplicationInsights.Web -Version 2.4.0
  

  该命令会自动安装所有依赖的同版本组件，避免版本不匹配。

2. 检查NuGet源并清理缓存 #

在家环境的NuGet源可能和办公室不同，导致拉取的包版本不一致：

• 打开工具 → 选项 → NuGet包管理器 → 包源，确保优先使用官方NuGet源，暂时禁用其他自定义源
• 清理NuGet缓存：在包管理器控制台执行 Clear-PackageCache，或者在选项页面点击“清除所有NuGet缓存”

3. 手动编辑项目文件修复依赖 #

如果卸载重装后仍有问题，可以直接修改项目文件：

• 右键项目 → 卸载项目 → 右键点击项目选择“编辑.csproj”
• 查找所有包含Microsoft.ApplicationInsights的<PackageReference>或<Reference>节点，将版本号统一为同一个值（比如2.4.0）
• 保存文件，重新加载项目，右键项目选择“还原NuGet包”

4. 跳过向导，手动添加Application Insights #

如果向导自动选择版本的逻辑有问题，可以手动操作：

• 右键项目 → 管理NuGet包 → 浏览，搜索Microsoft.ApplicationInsights.Web，选择一个稳定版本（确保所有依赖包版本匹配）并安装
• 手动配置Application Insights：在ApplicationInsights.config中填入你的Instrumentation Key，或在Web.config中添加对应的配置项

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