AppSync使用None数据源时GraphQL mutation返回列表为null问题求解

1. 列表透传返回null的修复方案 #

你遇到的问题有两个核心原因：

• 第一是请求映射模板中对results数组做了强制字符串序列化：用双引号包裹${context.arguments.input.results}会将数组直接转为字符串格式，和schema定义的[SearchResultOutput]数组类型不匹配，AppSync做类型校验时会自动返回null。
• 第二是你测试用的mutation字段名和schema定义不一致：schema中入参结构体的字段是results而非resultsIn，出参结构体的字段是results而非resultsOut，字段不匹配也会导致返回空值。

修复步骤： #

1. 修改请求映射模板，使用$util.toJson自动适配类型输出，不要手动加引号：

// REQUEST 映射模板
{
    "version": "2017-02-28",
    "payload": {
        "callId": $util.toJson($context.arguments.input.callId),
        "results": $util.toJson($context.arguments.input.results)
    }
}

响应映射模板无需修改，原有$util.toJson($context.result)逻辑正确。

2. 调整测试mutation的字段名和schema对齐：

mutation MyMutation {
  sendSearchResults(input: {results: [{assetId: "0001", score: 10}, {assetId: "0002", score: 22}], callId: "aaa-aaa-aaa"}) {
    callId
    results {
      assetId
      score
    }
  }
}

调整后即可正常返回完整的结果列表。

2. 临时数据透传方案合理性与优化建议 #

该方案完全合理，是AppSync None数据源的典型适用场景：None数据源本身就是为无持久化需求的逻辑透传、实时消息推送场景设计的，相比接入数据库的方案链路更短、延迟更低，完全匹配你的临时数据透传需求。

可参考的优化建议如下：

• 权限收敛：当前mutation和数据类型同时开启了API_KEY和Cognito用户池鉴权，建议拆分权限：mutation仅保留@aws_api_key权限（仅允许Lambda调用），前端订阅仅保留@aws_cognito_user_pools权限，避免前端直接调用mutation推送无效数据。
• 订阅过滤：如果需要前端仅接收对应自身会话的数据，可以在订阅指令中新增过滤规则，仅推送callId匹配当前用户会话的消息，避免全量广播浪费带宽。
• 参数校验：在resolver中新增参数合法性校验逻辑，比如callId为空、results数组长度为0时直接返回错误，避免无效数据触发订阅。
• 高推送场景优化：如果单API推送频率超过1000次/秒，可以开启AppSync实时消息的去重配置，对重复消息做过滤，减少不必要的消息下发。

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