在VSTO Excel插件中调用Azure Document Intelligence API失败求助

针对你遇到的VSTO插件调用Azure API失败但控制台正常的情况，可按以下步骤排查：

• 检查.NET框架版本一致性
  VSTO项目默认基于.NET Framework，而控制台项目如果是.NET Core/.NET 5+，两者的框架环境差异可能导致SDK兼容性问题。确认插件和控制台的目标框架版本一致，且满足Azure Document Intelligence SDK的最低要求（目前要求.NET Framework 4.7.2及以上）。

• 验证身份验证配置的正确性
  确保插件中使用的Azure端点、API密钥和控制台完全一致。注意VSTO插件读取配置依赖app.config，如果控制台用的是appsettings.json，要把配置项手动复制到插件的app.config中；也可以在代码中临时硬编码密钥和端点，排除配置读取错误的可能。

• 处理VSTO的安全与上下文限制
  VSTO插件运行在Excel进程内，可能受UAC或代码访问安全限制：

  1. 尝试以管理员身份启动Excel，测试是否是权限问题；
  2. 如果网络环境有代理，控制台可能自动使用系统代理，但VSTO插件需要显式配置：

     var handler = new HttpClientHandler
     {
         UseProxy = true,
         Proxy = new WebProxy("http://你的代理地址:端口")
     };
     var client = new DocumentIntelligenceClient(
         new Uri("你的Azure端点"), 
         new AzureKeyCredential("你的API密钥"),
         new DocumentIntelligenceClientOptions { HttpClient = handler });
     

  3. 强制启用TLS 1.2+（Azure服务要求），在API调用前添加：

     ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls13;
     

• 捕获详细异常信息
  把控制台的异常捕获逻辑迁移到插件中，输出完整的异常链（包括内部异常和堆栈跟踪），这能帮你定位具体问题：

  try
  {
      // 你的Azure API调用代码
  }
  catch (Exception ex)
  {
      MessageBox.Show($"错误：{ex.Message}\n内部错误：{ex.InnerException?.Message}\n堆栈跟踪：{ex.StackTrace}");
  }
  

• 核对Azure SDK包版本
  确认VSTO项目安装的Azure.AI.DocumentIntelligence包版本和控制台完全一致，避免版本差异导致的兼容性问题。可以卸载现有包，清理NuGet缓存后重新安装对应版本。

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