AWS Amplify与Flutter：嵌套GraphQL查询结果解析异常问题

问题根源 #

1. AppSync控制台与Flutter SDK返回格式差异：控制台中关联字段（如devices）返回带items的分页对象，但Amplify Flutter SDK会自动扁平化数组为直接的设备列表，而生成的Customer.fromJson代码仍按分页对象结构查找serializedData字段，导致解析失败。
2. ModelQueries.list默认不返回关联数据：Amplify的列表查询不会自动拉取子关联数据，需显式指定。

解决步骤 #

1. 显式指定关联字段查询（推荐） #

默认查询仅返回Customer基础字段，需通过includes参数关联拉取devices：

final request = ModelQueries.list(Customer.classType, 
  includes: [Customer.devices.name]
);
final response = await Amplify.API.query(request: request).response;

此方式下SDK会自动处理格式转换，无需修改生成的模型代码，返回的Customer对象将正确包含devices列表。

2. 自定义GraphQL查询（复杂场景） #

若需更灵活的查询逻辑，可编写自定义GraphQL查询，确保结构匹配SDK解析要求：

query GetCustomerWithDevices($id: ID!) {
  getCustomer(id: $id) {
    id
    first_name
    last_name
    email
    devices {
      items {
        id
        thing_name
        customer_id
      }
    }
  }
}

调用示例：

final response = await Amplify.API.query(
  request: GraphQLRequest<String>(
    document: '''上述GraphQL内容''',
    variables: {'id': '目标客户ID'},
  ),
).response;
// 手动解析时取 response.data['getCustomer']['devices']['items']

3. 禁止手动修改生成的模型代码 #

移除serializedData检查会破坏SDK的序列化逻辑，导致更多错误，应通过调整查询方式适配模型代码。

4. 验证数据关联与索引 #

• 确认Device数据的customer_id字段正确关联到对应Customer的id；
• 通过Amplify Studio或amplify status确认byCustomer索引已正确创建，索引失效会导致关联数据无法查询。

额外排查 #

• 更新依赖：运行flutter pub upgrade amplify_flutter amplify_api至最新版本，旧版本可能存在解析bug；
• 检查配置：确认amplifyconfiguration.dart中的AppSync端点、API密钥配置正确，权限问题也会导致数据未返回。

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