GCP Document AI API调用无响应问题排查求助

• 检查环境变量配置
  确认GOOGLE_APPLICATION_CREDENTIALS环境变量已正确指向JSON密钥文件路径，执行echo $GOOGLE_APPLICATION_CREDENTIALS验证路径有效性，同时确保密钥文件存在且当前用户有读取权限。未设置的话，Linux/macOS可执行export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"，Windows执行set GOOGLE_APPLICATION_CREDENTIALS=C:\path\to\key.json。

• 验证服务账号权限
  确保服务账号已分配Document AI Editor或Document AI Viewer角色，可在GCP控制台IAM页面查看角色配置。权限不足时添加对应角色，等待1-2分钟生效后重试。

• 确认API启用状态
  在GCP控制台API库中搜索"Document AI"，确认该API已在当前项目启用，未启用则点击启用按钮。

• 调试代码输出
  修改官方示例代码，添加异常捕获与日志输出，定位具体错误：

  try:
      result = client.process_document(request=request)
      print("API响应结果:", result)
  except Exception as e:
      print("API调用错误:", e)
  

• 核对区域与处理器配置
  确保代码中指定的处理器区域、ID与GCP控制台创建的处理器完全匹配，同时检查传入的文档路径正确、格式符合要求（支持PDF、JPG、PNG等）。

• 排查网络问题
  测试本地网络能否访问GCP API，执行curl https://documentai.googleapis.com/验证连通性。若使用代理，需配置HTTP_PROXY、HTTPS_PROXY环境变量。

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