DynamoDB使用Dynamoose时过滤排序报错：Filter Expression仅含非主键属性

错误原因 #

你遇到的错误是因为first_name是你创建的二级索引organization_id_first_name_index的排序键，属于索引的主键属性。DynamoDB明确规定：Filter Expression只能包含非主键类属性（包括表的主键和索引的主键），所以不能把索引的主键字段放到filter()里使用。

正确实现方式 #

因为你的二级索引已经把first_name设为排序键，要实现对它的过滤+排序，应该直接在查询阶段使用排序键的条件，而不是用Filter。根据你的需求分两种情况处理：

情况1：前缀匹配（支持索引优化） #

如果你的需求是匹配first_name以特定字符串开头的用户（比如找名字以"Li"开头的），可以用begins_with来替代contains，直接作为查询条件：

users.query("organization_id")
  .eq(user_organization_id)
  .where("first_name")
  .begins_with(first_name_prefix) // 比如传入"Li"
  .sort('ascending')
  .using('organization_id_first_name_index')
  .exec();

这种方式会直接利用二级索引的排序键进行范围查询，同时自然完成排序，性能远优于用Filter过滤。

情况2：任意包含的模糊匹配（无法用当前索引实现） #

如果你的需求是匹配first_name中任意位置包含指定字符串的用户（比如找名字里有"ohn"的），DynamoDB的二级索引做不到直接支持这种模糊查询。这种情况你可以考虑：

• 把first_name拆分成关键词（比如分词后存在单独的属性里），创建新的GSI或者用本地二级索引；
• 集成Elasticsearch这类全文搜索服务来处理模糊查询需求。

额外注意 #

你原来的代码里有个拼写错误：conatins应该是contains，不过即使修正这个拼写，依然会触发之前的错误，因为本质问题是字段类型不符合Filter的要求。

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