Lambda调用Textract超时求助：SageMaker可正常执行同代码

常见问题及解决办法 #

1. VPC配置导致网络不通 #

如果你的Lambda绑定了VPC，但未配置访问S3和Textract的网络路径，请求会因无法触达服务端最终超时。

• 解决：
  • 若无需VPC访问，直接将Lambda的VPC设置改为「无」，让Lambda直接访问AWS公有服务。
  • 必须使用VPC的话，要么给Lambda所在子网配置NAT网关以打通公网访问，要么为S3和Textract创建VPC端点走内网访问。

2. 文件大小超出同步API限制 #

detect_document_text是同步API，要求单页文档大小不超过5MB。若图片超限，SageMaker环境可能有隐性兼容处理，但Lambda会出现超时或无响应。

• 解决：先用几百KB的测试图片在Lambda中验证，确认是否为文件大小问题。如果是大文件或多页文档，改用异步API start_document_text_detection，之后轮询获取结果。

3. 角色信任策略配置错误 #

即使给Lambda角色配了S3和Textract全权限，若角色的信任策略未允许Lambda服务扮演该角色，也会导致调用失败。

• 解决：进入IAM控制台查看该角色的信任关系，确保包含以下配置：

  {
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "lambda.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
  }
  

4. Lambda资源不足 #

默认128MB内存的Lambda，网络带宽和CPU资源有限，可能导致请求响应缓慢甚至超时。

• 解决：将Lambda的内存配置调高至512MB或1GB，Lambda的网络和CPU资源会随内存提升而增加。

快速验证步骤 #

1. 先将Lambda的VPC设置改为「无」，重新测试调用是否成功。
2. 查看CloudWatch中的Lambda日志，确认是否有连接超时等具体错误提示。
3. 使用小体积测试图片运行，排除文件大小导致的问题。

内容的提问来源于stack exchange，提问作者A. S. K.