Node.js+TypeScript下DynamoDB非主键字段过滤查询问题求助

一、实现思路的错误修正 #

你的代码在查询逻辑上存在3个关键问题：

• 字段名大小写不匹配：表定义的字段是LdapGroup，但代码中ExpressionAttributeNames映射的是ldapGroups，DynamoDB对字段名大小写敏感，必须严格匹配。
• List类型筛选逻辑错误：判断List是否包含指定值不能用=，必须使用DynamoDB内置的contains()函数，语法为contains(列表字段, 目标值)。
• 属性值格式错误：DynamoDB的List元素是AttributeValue类型，筛选值必须符合该格式（比如字符串类型用{ S: "值" }），不能直接传字符串。

二、编译错误的解决方法 #

情况1：使用AWS SDK v2 #

如果你的项目基于AWS SDK v2，错误根源是混用了v3的类型定义，且未正确处理异步调用：

1. 替换类型：用aws-sdk/clients/dynamodb导出的ScanInput和ScanOutput替代ScanCommandInput/ScanCommandOutput。
2. 修正异步调用：v2的scan方法默认返回Request对象，必须调用.promise()才能获取Promise结果。
3. 严格类型约束：移除any，明确输入输出的类型。

修正后的代码：

import { ScanInput, ScanOutput } from "aws-sdk/clients/dynamodb";

public async getMemberList(): Promise<ScanOutput> {
  const input: ScanInput = {
    TableName: UserInfoDao.TABLE_NAME,
    ProjectionExpression: "alias",
    FilterExpression: "contains(#lg, :targetVal)",
    ExpressionAttributeNames: {
      "#lg": "LdapGroup" // 匹配表字段的正确名称
    },
    ExpressionAttributeValues: {
      ":targetVal": { S: "aws" } // 符合DynamoDB AttributeValue格式
    }
  };

  try {
    const ddbClient = DynamDBClient.getInstance();
    // v2 SDK必须调用.promise()获取异步结果
    return await ddbClient.scan(input).promise();
  } catch (error) {
    const message = `ERROR: Failed to retrieve alias for given ldapGroups:
    ERROR: ${JSON.stringify(error)}`;
    if (error instanceof Error) {
      error.message = message;
    }
    throw error;
  }
}

情况2：使用AWS SDK v3（推荐） #

如果使用v3 SDK，错误是因为直接调用了v2风格的scan方法，v3需要通过ScanCommand和send方法执行请求：

1. 导入v3的类型和命令：从@aws-sdk/client-dynamodb导出ScanCommand、ScanCommandInput、ScanCommandOutput。
2. 用ScanCommand包装输入参数，通过client.send()执行请求。

修正后的代码：

import { ScanCommand, ScanCommandInput, ScanCommandOutput } from "@aws-sdk/client-dynamodb";

public async getMemberList(): Promise<ScanCommandOutput> {
  const input: ScanCommandInput = {
    TableName: UserInfoDao.TABLE_NAME,
    ProjectionExpression: "alias",
    FilterExpression: "contains(#lg, :targetVal)",
    ExpressionAttributeNames: {
      "#lg": "LdapGroup"
    },
    ExpressionAttributeValues: {
      ":targetVal": { S: "aws" }
    }
  };

  try {
    const ddbClient = DynamDBClient.getInstance(); // 确保实例是v3的DynamoDBClient
    const command = new ScanCommand(input);
    return await ddbClient.send(command);
  } catch (error) {
    const message = `ERROR: Failed to retrieve alias for given ldapGroups:
    ERROR: ${JSON.stringify(error)}`;
    if (error instanceof Error) {
      error.message = message;
    }
    throw error;
  }
}

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