DynamoDB复合GSI主键创建及查询报错、无结果问题排查

你遇到的报错和空结果问题，本质是三个认知和操作错误：

• 误解了DynamoDB复合分区键的实现逻辑：DynamoDB的分区键（包括GSI的分区键）永远是单个属性，不存在服务端自动把多个字段拼接成复合分区键的能力。你在创建GSI时如果只指定了一个拼接值作为分区键，却没有主动给每条数据写入这个拼接属性，索引里根本不会存在对应键值。
• 查询条件没有命中GSI的分区键：不管你用哪种拼接格式，查询时WHERE子句写的是三个独立原始字段的过滤条件，完全没有对GSI实际的分区键属性做等值匹配。DynamoDB查询带ORDER BY时强制要求先对分区键做非可选的等值匹配，这就是你拿到ValidationException的直接原因。
• 拼接格式没有对应实际存储的值：你测试的两种拼接格式只是你设想的规则，但既没有把拼接后的值实际写入数据，也没有在查询时传入拼接好的完整键值，自然匹配不到任何数据。第二种加方括号的拼接格式属于冗余设计，容易引入转义、类型不匹配问题，完全没必要用。

1. 配置GSI结构 #

创建GSI时，单独指定一个专属属性作为GSI分区键，比如命名为gsi_pk，排序键按你的需求设为updated，根据业务需要配置投影属性即可。拼接规则直接用[business_id字符串值]#[type_id字符串值]#[partner_id字符串值]的格式，不要加多余的方括号。

2. 写入数据时主动生成复合键值 #

所有写入主表的数据（包括存量历史数据），都需要在业务层把三个字段统一转为字符串后，按约定格式拼接，赋值给gsi_pk属性，示例数据结构如下：

{
  "business_id": 435634652,
  "type_id": 2,
  "partner_id": 69992528,
  "updated": "2024-05-20T14:30:00Z",
  "gsi_pk": "435634652#2#69992528",
  "其他业务属性": "对应值"
}

注意：存量数据需要批量补写gsi_pk字段，写入完成后等待GSI完成回灌（控制台可以看GSI的Backfilling状态，等状态变为Active再查询），避免漏数。拼接时一定要把数字类型的ID统一转为字符串，否则会因为类型不一致导致匹配失败。

3. 编写符合规则的查询语句 #

查询时直接对GSI的分区键gsi_pk做等值匹配，不要拆分写三个原始字段的条件，正确的带排序查询语句如下：

SELECT *
FROM "items"."composite_key-index" 
WHERE gsi_pk = '435634652#2#69992528'
ORDER BY updated ASC

该语句满足分区键等值匹配的强制要求，只要键值拼接正确、GSI数据同步完成，就能正常返回按updated升序排列的匹配结果。

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