如何在 ECS 任务中正确配置 AWS 凭据与区域以安全调用 SQS_技术教程

本文详解如何为 ecs 任务配置 iam 角色和默认区域，避免因缺少 `region` 或凭据导致的 boto3 报错（如 “region not provided error”），实现无需硬编码密钥的安全 sqs 消息发送。

在 Amazon ECS 中运行 Python 应用调用 AWS 服务（如 SQS）时，本地开发环境能正常工作，但部署到 ECS 后却报错 You must specify a region，甚至 queue 对象为 None，这通常不是代码逻辑问题，而是运行时 AWS SDK 环境配置缺失所致。

根本原因在于：ECS 容器默认不自动继承 EC2 实例的区域信息，且若未显式配置 IAM 权限来源，boto3 将无法通过默认凭证链（ECSCredentialsProvider）获取临时凭证和区域上下文。

✅ 正确解决方案分两步：

1. 为任务分配 Task IAM Role（非 Execution Role）

Task IAM Role 是授予容器内应用权限的核心机制——它让容器中的 boto3 自动使用 ECS 提供的临时凭证（通过 http://169.254.170.2 元数据端点）。请确保：

在 ECS 任务定义（Task Definition）中，正确填写 Task Role ARN（而非仅 Execution Role）；
该 Role 已附加具备 SQS 发送权限的策略，例如：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sqs:SendMessage",
      "Resource": "arn:aws:sqs:us-east-1:123456789012:my-queue"
    }
  ]
}

⚠️ 注意：Task Role 与 Task Execution Role 是两个独立角色。后者仅用于 ECS Agent 拉取镜像、写 CloudWatch Lo
gs；前者才决定你的应用能访问哪些 AWS 资源。

2. 显式设置 AWS_DEFAULT_REGION 环境变量

即使拥有有效 IAM Role，boto3 仍需明确知道目标区域才能初始化资源客户端。ECS 不会自动注入 AWS_DEFAULT_REGION，因此必须在任务定义的容器配置中添加：

"environment": [
  {
    "name": "AWS_DEFAULT_REGION",
    "value": "us-east-1"
  }
]

或在 docker-compose.yml（如使用 Copilot）中声明：

environments:
  production:
    variables:
      AWS_DEFAULT_REGION: us-east-1

优化后的 Python 代码（无需硬编码）

import boto3
import json

# boto3 将自动从 ECS 任务角色获取凭证，并读取 AWS_DEFAULT_REGION
sqs = boto3.resource('sqs')

# 推荐：通过 queue URL 显式指定队列（更健壮，避免 region/queue name 解析歧义）
queue = sqs.get_queue_by_name(QueueName='my-queue')  # 需确保 QueueName 在当前 region 存在

response = queue.send_message(
    MessageBody=json.dumps({"test": "test"}),
    MessageGroupId="default-group"  # 若启用 FIFO 队列则必需
)
print(f"Message sent: {response.get('MessageId')}")

验证与调试建议

登录容器执行 curl http://169.254.170.2/latest/meta-data/identity-credentials/ecs/，确认元数据端点可访问（需启用 awsvpc 或 bridge 网络模式并配置 enableExecuteCommand）；
在容器内运行 aws sts get-caller-identity（需预装 AWS CLI）验证凭证有效性；
检查 CloudWatch Logs 中是否出现 Unable to locate credentials 或 InvalidClientTokenId 类错误。

总结：安全调用 SQS 的关键在于「职责分离」——用 Task IAM Role 管理权限，用 AWS_DEFAULT_REGION 环境变量声明区域上下文。二者缺一不可，且绝不可将 Access Key/Secret 硬编码进源码，这是 AWS 安全最佳实践的底线要求。