使用AWS SDK V3在JavaScript中查询DynamoDB属性值范围遇执行阻塞

问题原因分析 #

• 区域配置无效：eu-west不是合法的AWS区域标识，必须指定完整区域（如eu-west-1），否则客户端无法建立有效连接，导致请求卡住。
• 客户端与命令不匹配：从@aws-sdk/lib-dynamodb导入的ScanCommand是为DynamoDBDocumentClient设计的，不能用低级的DynamoDBClient发送，二者混用会导致请求异常。
• 表达式参数格式错误：使用DynamoDBDocumentClient时，ExpressionAttributeNames只需字符串映射，ExpressionAttributeValues直接传入原始值即可，无需手动指定DynamoDB类型（如{"S": "..."}或{"N": "..."}）。

修正后的代码 #

// Load the AWS SDK V3 files for JS
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { 
  DynamoDBDocumentClient,
  ScanCommand 
} from "@aws-sdk/lib-dynamodb";

const log = (msg) => console.log(`[SCENARIO] ${msg}`);

// 修正区域为合法值，根据实际使用区域调整
const dynamodbClient = new DynamoDBClient({ region: "eu-west-1" });
const dynamodbDocClient = DynamoDBDocumentClient.from(dynamodbClient);

// Set a table name that we can use later on
const tableName = "my-database";

export const handler = async (event, context) => {
  let articles = [];
  const scanParams = {
    TableName: tableName,
    FilterExpression: "#y between :y1 and :y2",
    // 修正ExpressionAttributeNames格式，直接映射字符串
    ExpressionAttributeNames: { "#y": "recent" },
    // 修正ExpressionAttributeValues，直接传入原始数值
    ExpressionAttributeValues: { ":y1": 1, ":y2": 5 },
    ConsistentRead: true,
    Select: "ALL_ATTRIBUTES",
  };
  
  // 使用DynamoDBDocumentClient发送ScanCommand
  const command = new ScanCommand(scanParams);
  try {
    const response = await dynamodbDocClient.send(command);
    console.log(response.Items);
    articles = response.Items;
    return { statusCode: 200, body: JSON.stringify(articles) };
  } catch (err) {
    console.error(err);
    return { statusCode: 500, body: JSON.stringify(err.message) };
  }
};

额外说明 #

• 如果坚持使用低级DynamoDBClient，需要从@aws-sdk/client-dynamodb导入对应的ScanCommand，并且表达式参数要严格遵循DynamoDB原生类型格式，但推荐使用DynamoDBDocumentClient，它会自动处理类型转换，简化代码。
• 启用ConsistentRead会增加读取延迟和成本，若不需要强一致性，建议关闭该参数。

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