You need to enable JavaScript to run this app. 使用AWS Amplify/AppSync GraphQL客户端查询遇Store error及配置后无数据问题
优惠活动
大模型
产品
解决方案
定价
更多

使用AWS Amplify/AppSync GraphQL客户端查询遇Store error及配置后无数据问题

核心报错根因

AWSAppSyncClient 底层基于 Apollo 客户端实现,默认缓存键生成逻辑对AppSync自动生成的分页连接类型存在适配缺陷:

  • 列表查询返回的顶层分页包装对象listInstitutions的__typename为ModelInstitutionConnection,这类分页结构本身不存在全局唯一的id字段
  • 客户端默认生成缓存键时,会尝试读取对象的id字段,取不到值就拼接出ModelInstitutionConnection:undefined这类无意义的缓存键
  • 多次写入同结构分页结果时,就会触发“应用尝试写入无id对象,但缓存已存在对应条目”的存储冲突,正常的网络响应会被拦截为网络错误抛出。

此前测试配置无效的原因

你尝试补充的cacheOptions配置逻辑存在硬错误:

// 错误的测试配置
cacheOptions: {
  dataIdFromObject: (obj: any) => `${obj.__typename}:${obj.myKey}`,
}

代码里读取了不存在的myKey字段,所有业务对象最终生成的缓存键全是xxx:undefined,客户端无法建立查询和结果的有效映射,就会直接返回空数组,根本不会发起实际的 DynamoDB 拉取请求。

可正常运行的修正方案

1. 适配正确的缓存键生成规则

按对象类型区分缓存键生成逻辑:

  • 对带有全局唯一id的业务实体(比如Institution、Admin),使用__typename:id生成全局缓存键,支持跨查询复用实体数据
  • 对没有自带id的分页连接对象(比如所有后缀为Connection的AppSync自动生成的分页包装结构),返回null,告知Apollo客户端不要为这类对象生成全局缓存键,仅将其和当前查询做局部绑定,从根源上避免缓存键冲突

修正后的客户端初始化代码:

import { defaultDataIdFromObject } from 'apollo-cache-inmemory';

export const client = new AWSAppSyncClient({
  url: awsconfig.aws_appsync_graphqlEndpoint,
  region: awsconfig.aws_appsync_region,
  auth: {
    type: awsconfig.aws_appsync_authenticationType,
    jwtToken: async () =>
      (await Auth.currentSession()).getAccessToken().getJwtToken(),
  },
  cacheOptions: {
    dataIdFromObject: (obj) => {
      // 跳过所有分页连接类型,不生成全局缓存键
      if (obj.__typename?.endsWith('Connection')) return null;
      // 其余类型沿用Apollo默认规则生成缓存键
      return defaultDataIdFromObject(obj);
    }
  }
});

2. 清理本地残留的失效缓存

此前的错误运行已经把ModelInstitutionConnection:undefined这类无效条目写入了浏览器本地离线缓存,就算修正了配置,旧的坏条目依然会触发冲突。可以通过两种方式快速清理:

  • 开发阶段直接清除站点的本地存储、IndexedDB缓存后刷新页面
  • 生产环境可以临时加disableOffline: true参数初始化客户端,跑通一次正常查询后,再移除该参数开启离线缓存能力

3. 查询结构注意事项

当前查询中嵌套的classes、learners字段只请求了nextToken,这类结构本身是ModelClassConnection、ModelLearnerConnection类型,按照上面的规则会被跳过全局缓存,不会触发报错。后续修改查询时,不要在这类分页嵌套结构里强行请求实体字段却不配置对应缓存键,否则会再次触发同类存储错误。


内容的提问来源于stack exchange,提问作者Ragav Y

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 17:06:02