调用Azure Document Intelligence begin_analyze_document时遇连接字符串错误

可能的原因及解决步骤 #

• 检查端点和密钥的完整性与正确性
  确保endpoint是从Azure门户Document Intelligence服务的"密钥和终结点"页面复制的完整地址，没有多余空格、换行或截断。key需要使用完整的密钥值，代码中显示的ANZ...CzH是截断示例，实际要替换为门户中复制的完整密钥（两个密钥任选其一即可）。

• 验证客户端初始化的依赖导入
  确认代码已导入所需的类，避免因缺失依赖导致隐式异常：

  from azure.ai.documentintelligence import DocumentIntelligenceClient
  from azure.core.credentials import AzureKeyCredential
  from azure.ai.documentintelligence.models import AnalyzeDocumentRequest, AnalyzeResult
  

• 排查运行环境的环境变量冲突
  如果在Azure Cloud Shell或门户内置环境运行代码，检查是否存在AZURE_COGNITIVE_SERVICES_CONNECTION_STRING环境变量。部分SDK会优先读取该变量，若变量为空或格式错误，会覆盖代码中显式传入的端点和密钥。可通过对应命令检查：

  • Linux/macOS：echo $AZURE_COGNITIVE_SERVICES_CONNECTION_STRING
  • Windows：echo %AZURE_COGNITIVE_SERVICES_CONNECTION_STRING%
    若存在错误值，删除该环境变量后重新运行代码。

• 确认网络访问权限（可选）
  若运行环境有网络限制，需确保允许访问Document Intelligence服务的端点地址。不过该报错更偏向身份验证参数问题，优先完成上述步骤后再排查网络。

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