ECS容器内发送SQS消息失败且无错误详情的调试求助

以下是针对ECS容器中Node.js调用AWS SDK v3发送SQS消息抛出空错误的具体调试步骤：

• 增强错误日志细节
  目前的日志仅输出error对象，部分错误的属性在序列化时会丢失。修改日志代码，输出错误的完整信息：

  this.logger.warn("Failed to alert transformation issue", {
    errorMessage: error.message,
    errorName: error.name,
    errorStack: error.stack,
    fullError: JSON.stringify(error, Object.getOwnPropertyNames(error), 2)
  });
  

  这样能捕获到AWS SDK错误中可能隐藏的$metadata、name等关键属性，定位错误根源。

• 验证ECS环境变量配置
  确认ECS容器中以下环境变量是否正确设置：

  • AWS_REGION：与SQS队列所在区域一致
  • SQS_URL_TRANSFORMATIONS_ALERT：队列URL无拼写错误
  • AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY：密钥有效且未过期（若使用IAM角色则无需配置，需检查角色挂载）
    可在代码中临时添加非敏感变量的日志输出（如仅打印AWS_REGION值），或在ECS任务定义中查看变量配置是否生效。

• 重新验证IAM权限配置
  即使已配置权限，仍需确认：

  • ECS任务角色/执行角色的权限策略包含sqs:SendMessage动作，且资源为目标SQS队列的ARN（而非仅URL）
  • 权限策略无额外限制条件（如源IP、时间范围）导致权限失效
    可在ECS容器内安装AWS CLI，执行测试命令验证权限：

  aws sqs send-message --queue-url $SQS_URL_TRANSFORMATIONS_ALERT --message-body "test" --region $AWS_REGION
  

  若命令执行成功，说明权限和环境正常，问题出在代码层面；若失败，根据CLI返回的错误信息定位权限问题。

• 开启AWS SDK调试日志
  启用SDK的详细日志，查看请求的完整流程（包括签名、请求参数、响应状态）：

  import { SQSClient, SendMessageCommand } from "@aws-sdk/client-sqs";
  import { Logger } from "@aws-sdk/types";
  
  const sqsClient = new SQSClient({
    region: process.env.AWS_REGION,
    maxAttempts: MAX_ATTEMPTS,
    credentials: {
        accessKeyId: process.env.AWS_ACCESS_KEY_ID,
        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
    },
    // 开启调试日志
    logger: {
      log: (message) => console.debug("[AWS SDK Debug]", message)
    } as Logger
  });
  

  也可通过设置环境变量AWS_DEBUG_LOG=true开启全局SDK调试日志，注意调试日志包含敏感信息，生产环境需及时关闭。

• 检查VPC与网络配置
  若ECS任务部署在VPC内：

  • 确认安全组允许出站HTTPS（443端口）访问SQS服务
  • 若使用VPC端点，需确认端点服务名称为com.amazonaws.<region>.sqs，且端点的安全组允许ECS任务的流量访问
    可在容器内执行网络测试：

  curl -v https://sqs.$AWS_REGION.amazonaws.com
  

  若无法建立连接，说明网络配置存在问题。

• 核对Node.js与SDK版本兼容性
  确认ECS容器中的Node.js版本与本地测试版本一致（AWS SDK v3要求Node.js 14.x及以上），同时检查@aws-sdk/client-sqs的版本是否与本地一致，避免版本差异导致的兼容性问题。

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