DynamoDB ScanCommand过滤器报错及无结果问题求助

问题描述 #

作为DynamoDB新手，在使用ScanCommand添加过滤条件时遇到两类问题：

1. 使用ScanFilter时抛出异常 #

错误信息：

ValidationException: One or more parameter values were invalid: ComparisonOperator CONTAINS is not valid for M AttributeValue type

对应代码：

export async function searchGraba({ term }: { term: string }) { 
  const pks = await db.send( 
    new ScanCommand({ 
      TableName: "Event", 
      IndexName: "id-index", 
      ScanFilter: 
      { id: 
        { ComparisonOperator: "CONTAINS", 
        AttributeValueList: [{ S: term }], 
        }, 
      }, 
    })); 
    console.log(pks.Items); 
    return pks.Items; 
}

2. 改用FilterExpression后无报错，但返回结果为空 #

对应代码：

export async function searchGraba({ term }: { term: string }) {
  const pks = await db.send(
    new ScanCommand({
      TableName: "Event",
      IndexName: "id-index",
      FilterExpression: "contains(#id, :id)",
      ExpressionAttributeNames: { "#id": "id" },
      ExpressionAttributeValues: { ":id": { S: term } },
    })
  );
  console.log(pks.Items);
  return pks.Items;
}

已知条件：DB客户端配置正常，可执行无过滤的查询/扫描；表结构中id属性类型为S（字符串）。

问题原因 #

1. ScanFilter异常原因 #

• ScanFilter是AWS已弃用的旧参数，官方明确推荐使用FilterExpression替代。
• 你使用的是DynamoDBDocument文档客户端，它会自动对参数进行**marshall（JS对象转DynamoDB AttributeValue）**处理。手动传入的{ S: term }会被文档客户端再次包装成M（Map）类型，而表中id是S类型，CONTAINS操作符不支持对M类型进行操作，因此抛出异常。

2. FilterExpression返回空原因 #

同样因为文档客户端的自动marshall机制：你手动指定的{ ":id": { S: term } }会被当成普通JS对象处理，最终转成M类型的AttributeValue。而表中id是S类型，contains比较的是不同类型的值，自然匹配不到任何结果。

解决方案 #

核心修复：使用文档客户端的简化参数格式 #

文档客户端的核心优势就是自动处理数据格式转换，无需手动构建AttributeValue对象（如{ S: term }），直接传入JS原生类型即可。

修改后的代码：

export async function searchGraba({ term }: { term: string }) {
  const pks = await db.send(
    new ScanCommand({
      TableName: "Event",
      IndexName: "id-index",
      FilterExpression: "contains(#id, :id)",
      ExpressionAttributeNames: { "#id": "id" },
      ExpressionAttributeValues: { ":id": term }, // 直接传入字符串，无需手动包装
    })
  );
  console.log(pks.Items);
  return pks.Items;
}

额外优化：删除多余索引 #

从表结构可以看到，id-index全局二级索引的主键与表的主键完全一致（都是id），且投影类型为ALL，这个索引完全多余——扫描原表和扫描该索引的效果、性能一致，还会额外占用存储和写入资源，建议删除。

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