升级AWS SDK v2至v3导致Synthetics Canary中DynamoDB调用失败

问题核心 #

将AWS SDK从v2升级到v3后，代码在测试环境、本地及Lambda中均可正常调用DynamoDB的getItem接口，但在Synthetics Canary中执行时，仅返回请求元数据$metadata，实际Item完全缺失。对比日志发现，v2版本使用HTTPS调用DynamoDB端点，而v3版本自动使用了HTTP请求。

关键排查点 #

• 尝试过v3的send()+GetItemCommand调用风格，以及调整客户端的endpoint和tls参数，但未解决问题，推测是参数配置方式不正确。
• DynamoDB服务仅接受HTTPS请求，HTTP请求即使返回200状态码，也不会返回有效Item数据，这是导致仅返回元数据的根本原因。

解决方案 #

显式强制DynamoDB v3客户端使用HTTPS协议，并正确配置端点及TLS参数，同时采用v3推荐的命令式调用方式：

'use strict';

const { DynamoDB, GetItemCommand } = require('@aws-sdk/client-dynamodb');

// 初始化客户端时显式指定HTTPS端点、开启TLS并明确区域
const dynamodb = new DynamoDB({
  apiVersion: '2012-08-10',
  region: 'eu-central-1',
  endpoint: 'https://dynamodb.eu-central-1.amazonaws.com',
  tls: true
});

async function getAttributeByKey(table, keyName, keyValue, attributeName) {
  const command = new GetItemCommand({
    TableName: table,
    Key: {
      [keyName]: { S: keyValue }
    }
  });
  
  const response = await dynamodb.send(command);
  // 安全解构，避免Item不存在时报错
  return response.Item?.[attributeName]?.S;
}

生效原因 #

1. 强制HTTPS传输：直接指定带https://前缀的端点，彻底避免客户端自动降级到HTTP。
2. 明确TLS配置：tls: true参数确保客户端启用加密传输，与v2行为保持一致。
3. v3标准调用方式：使用GetItemCommand配合send()是AWS SDK v3官方推荐的调用模式，比直接调用客户端方法更稳定，适配不同执行环境。

额外验证项 #

• 确认Synthetics Canary的IAM角色拥有dynamodb:GetItem权限，权限配置与v2时代保持一致。
• 检查Canary的网络出站规则，确保允许访问DynamoDB的HTTPS端点（端口443）。

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