如何设计DynamoDB表以支持按username或handle快速查询？

你的核心思路是可行的，以下是更落地的细化设计：

主表结构设计 #

• 主键（PK/SK）：
  • PK：USER#{username}（username取自Cognito JWT中的用户唯一标识）
  • SK：固定为PROFILE（每个用户仅存一份资料，固定SK可简化单条数据的精准查询）
• 核心字段：
  • username：存储原始用户名，用于关联Cognito认证信息
  • handle：用户自定义的专属标识（需保证全局唯一）
  • 业务字段：display_name、bio、avatar_url等用户资料字段

全局二级索引（GSI）设计 #

创建名为HandleIndex的GSI，用于通过handle快速定位用户：

• GSI主键：
  • PK：HANDLE#{handle}
  • SK：固定为PROFILE
• 投影策略：选择ALL（若仅需查询部分字段，可按需投影以降低存储成本）

查询逻辑 #

• 通过JWT中的username查询：直接执行GetItem操作，传入PK=USER#{username} + SK=PROFILE，毫秒级返回用户全量资料
• 通过handle查询：针对HandleIndex执行Query操作，传入PK=HANDLE#{handle} + SK=PROFILE，快速获取对应用户资料

关键注意事项 #

• handle唯一性校验：写入前先通过HandleIndex查询该handle是否已存在，或使用DynamoDB条件表达式attribute_not_exists(HANDLE#{handle})确保写入时无冲突
• JWT有效性验证：解析JWT时必须校验签名、过期时间等字段，避免非法请求
• 字段冗余优化：主表直接存储handle字段，无需通过GSI反向查询，减少额外请求开销

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