Lambda解析器未填充GraphQL字段问题（AWS Amplify Gen1 v6）

问题概述 #

使用Amplify Gen1 v6搭建GraphQL API实现笔记系统，需求是已认证用户可创建笔记，且能读取同属Cognito组用户创建的笔记。但实际遇到以下问题：

• DynamoDB中groups字段未被Lambda解析器填充，导致同组用户查询返回空列表
• 修改Schema解决了认证错误，但groups字段仍未自动填充
• Amplify生成的UI组件将group字段设为用户输入项，而非使用Lambda返回的用户组信息

核心问题分析 #

1. Auth规则字段不匹配：Schema中@auth规则的groupsField设为"group"，但实际字段名为"groups"，导致权限校验与字段映射错位
2. @function触发时机错误：默认@function在字段解析时触发，而非创建笔记时自动写入DynamoDB
3. Lambda返回格式不符合要求：Amplify的@function期望返回包含字段键值对的对象，而非直接返回数组
4. 生成UI暴露可编辑字段：自动生成的UI会将groups字段作为用户输入项，干扰自动填充逻辑

修复步骤 #

1. 修正Schema配置 #

调整Auth规则的groupsField与字段名一致，并指定@function在create mutation时触发：

type Todo @model @auth(rules: [
    { allow: groups, groupsField: "groups", operations: [read, update] },
    { allow: owner, operations: [create] }
]) {
  id: ID!
  text: String!
  groups: [String] @function(name: "setGroupField-${env}", directive: "create")
}

2. 修正Lambda解析器返回格式 #

Amplify的@function要求返回包含目标字段的对象，而非直接返回数组，修改Lambda代码：

import json

def handler(event, context):
    # 提取用户所属的Cognito组
    groups = event['identity']['claims'].get('cognito:groups', [])
    
    if not groups:
        raise Exception("用户未加入任何Cognito组")
    
    # 返回符合要求的键值对格式
    return {
        "groups": groups
    }

3. 重新部署后端 #

运行命令让修改生效：

amplify push

4. 调整自动生成的UI组件 #

找到Amplify生成的笔记创建表单组件，移除groups字段的输入框，确保该字段完全由Lambda自动填充，不允许用户手动输入。

验证方法 #

1. 用已加入Cognito组的用户创建笔记，查看DynamoDB的Todo表，确认groups字段已填充用户所属组
2. 用同组的其他用户查询笔记，确认能正常返回该笔记
3. 用其他组的用户查询，确认无法返回该笔记，验证权限规则生效

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