DynamoDB二级索引查询与定义问题（Serverless部署报错）

看起来你在配置类似Slack的消息表索引时，混淆了**本地二级索引（LSI）和全局二级索引（GSI）**的核心区别，这也是导致各种报错的根源。我来帮你一步步理清问题，给出正确的配置方案：

首先，明确需求与索引类型的匹配 #

你的需求是能通过messageId（主键）、room、userId三个维度查询数据，其中room和userId是独立的查询维度，不需要和messageId绑定——这种场景完全适合用全局二级索引（GSI），而不是你之前尝试的本地二级索引（LSI）。

LSI的限制非常严格：它必须共享表的HASH键（也就是你的messageId），只能添加不同的RANGE键，适合比如“按messageId+时间排序”这类和主键绑定的查询场景，但完全不适合单独按room或userId查询的需求。

原有配置的核心错误点 #

1. 错误使用LSI：你给roomIndex和userIdIndex配置成了LSI，但LSI的HASH键必须和表的HASH键一致（也就是messageId），你却用了room和userId作为LSI的HASH键，直接触发了属性定义和键架构不一致的报错。
2. 不必要的表RANGE键：你为了满足LSI的要求添加了userId作为表的RANGE键，但其实如果用GSI的话，表完全可以只保留messageId作为HASH键，不需要RANGE键。
3. 索引键架构误解：部分报错提示索引没有RANGE键，这是因为你可能误把GSI当成了需要强制RANGE键的结构——GSI可以只有HASH键，不需要RANGE键，除非你需要在同一维度下排序。

正确的Serverless.yml配置 #

下面是适配你需求的正确配置，注释里会说明每个部分的作用：

resources:
  Resources:
    MessagesDynamoDBTable:
      Type: 'AWS::DynamoDB::Table'
      Properties:
        # 定义所有在表和索引中用到的属性及其类型
        AttributeDefinitions:
          - AttributeName: messageId
            AttributeType: S
          - AttributeName: room
            AttributeType: S
          - AttributeName: userId
            AttributeType: S
        # 表的主键：仅用messageId作为HASH键，不需要RANGE键
        KeySchema:
          - AttributeName: messageId
            KeyType: HASH
        # 配置全局二级索引，满足按room和userId查询的需求
        GlobalSecondaryIndexes:
          # 按room查询的索引
          - IndexName: roomIndex
            KeySchema:
              - AttributeName: room
                KeyType: HASH
            # 投影类型：KEYS_ONLY表示只投影主键和索引键，节省存储
            Projection:
              ProjectionType: "KEYS_ONLY"
            # 索引的读写容量（如果用按需模式可以去掉这部分，改用BillingMode: PAY_PER_REQUEST）
            ProvisionedThroughput:
              ReadCapacityUnits: 1
              WriteCapacityUnits: 1
          # 按userId查询的索引
          - IndexName: userIdIndex
            KeySchema:
              - AttributeName: userId
                KeyType: HASH
            Projection:
              ProjectionType: "KEYS_ONLY"
            ProvisionedThroughput:
              ReadCapacityUnits: 1
              WriteCapacityUnits: 1
        # 表的读写容量
        ProvisionedThroughput:
          ReadCapacityUnits: 1
          WriteCapacityUnits: 1
        TableName: ${self:custom.tableName}

额外说明 #

• 如果需要在room或userId的查询结果里按时间排序，可以给对应的GSI添加RANGE键。比如给roomIndex添加timestamp作为RANGE键，只需要在AttributeDefinitions里新增timestamp的定义，然后在roomIndex的KeySchema里加上：

  - AttributeName: timestamp
    KeyType: RANGE
  

• 如果你想用DynamoDB的按需计费模式，可以去掉所有ProvisionedThroughput配置，在Properties里添加：

  BillingMode: PAY_PER_REQUEST
  

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