使用aws-sdk-comprehend gem调用AWS Comprehend遇请求异常排查

首先明确：Aws::Comprehend::Errors::InvalidRequestException 核心是请求参数不符合Comprehend API的要求，而非凭证问题（凭证错误通常报AccessDeniedException）。结合你的情况，按以下顺序排查：

1. 先查请求参数是否合规 #

Comprehend的detect_entities接口有硬限制：

• 单条文本最多5000字节（中文每个字符占3字节，别超）
• 语言代码必须是官方支持的，比如简体中文用zh，英文用en，写错成cn直接报错
• 文本不能是空或全空白

比如这段错误代码会直接触发异常：

client = Aws::Comprehend::Client.new(region: 'us-east-1')
client.detect_entities(text: '', language_code: 'cn') # 空文本+错误语言码

2. 确认客户端区域配置正确 #

Comprehend不是所有AWS区域都提供服务，而且要和你的IAM凭证所属区域匹配。比如你之前用Rekognition的区域是ap-southeast-1，但Comprehend在该区域是否可用？常见可用区域比如us-east-1、ap-northeast-1、ap-southeast-2。

正确配置示例：

client = Aws::Comprehend::Client.new(region: 'ap-southeast-2')

3. 检查IAM权限是否包含Comprehend操作 #

Rekognition的权限不通用，必须给IAM用户/角色单独加comprehend:DetectEntities权限，示例策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "comprehend:DetectEntities",
      "Resource": "*"
    }
  ]
}

注：权限不足一般报AccessDeniedException，但如果同时存在参数错误，会优先触发参数异常，所以先搞定参数。

4. 简化环境变量，避免冗余 #

你配置了4个凭证变量，AWS SDK for Ruby优先读AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY（新格式），旧的AWSAccessKeyId/AWSSecretKey是兼容但没必要留，删掉旧的，只保留新格式两个变量，避免加载冲突。

可用的调用示例 #

以下是Rails中验证过的实体提取代码：

# 方式1：自动加载凭证和区域（推荐，确保环境变量有AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION）
client = Aws::Comprehend::Client.new

# 方式2：手动指定（如果自动加载有问题）
client = Aws::Comprehend::Client.new(
  access_key_id: ENV['AWS_ACCESS_KEY_ID'],
  secret_access_key: ENV['AWS_SECRET_ACCESS_KEY'],
  region: 'us-east-1'
)

# 调用接口
response = client.detect_entities(
  text: '明天上午10点，我要去北京朝阳区的星巴克见王经理',
  language_code: 'zh'
)

# 处理返回结果
response.entities.each do |entity|
  puts "类型：#{entity.type}，内容：#{entity.text}，置信度：#{entity.score}"
end

额外排查点 #

• 确保文本是UTF-8编码，Comprehend不支持其他编码
• 批量处理用batch_detect_entities的话，最多25条文本，总长度不超10000字节

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