本文详解如何为 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 Logs；前者才决定你的应用能访问哪些 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 安全最佳实践的底线要求。
