使用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
相关产品推荐
相关产品推荐

