游标分页结构下的Apollo缓存更新:发送新私信后如何同步会话消息列表
游标分页结构的私信消息缓存更新实现
核心调整逻辑
针对cursor based pagination的缓存结构,需要修正原非游标写法和结构不匹配的三个核心问题:
- 游标结构下的
edges是元素为{ cursor: string, node: MessageNode }的数组,不能直接把单个消息节点赋值给整个edges字段 - 新发送的消息属于会话最新条目,需要以标准edge对象的形式插入到现有
edges数组的对应位置,不能替换原有已加载的历史消息 - 需要同步更新
pageInfo的对应字段,保证后续分页加载的游标逻辑不会出错
具体实现代码
基于你原本使用immer produce 做不可变更新的写法,调整后的update逻辑如下:
const [sendMessage] = useMutation(SEND_MESSAGE, { optimisticResponse: { // 按照接口返回结构构造模拟响应,替换原有的true写法 data: { sendMessage: { data: { id: '临时乐观id', content: { body: '用户输入的实时内容' } // 其他发送接口约定返回的字段 } } } }, update(cache, result) { // 读取缓存中已有的会话分页数据 const existingMessages = cache.readQuery({ query: CONVERSATION }); // 获取发送接口返回的新消息节点(乐观更新阶段是构造的模拟数据,服务端返回后替换为真实数据) const newMessageNode = result?.data?.sendMessage?.data; // 容错处理:无缓存/无返回数据时直接中断流程 if (!existingMessages?.conversation?.data || !newMessageNode) return; const newMessages = produce(existingMessages, (draft) => { const conversationPageData = draft.conversation.data; // 构造符合游标规范的edge对象,游标可直接复用新消息的id作为唯一标识 const newEdge = { cursor: newMessageNode.id, node: newMessageNode }; // 按列表渲染顺序插入新edge: // 若最新消息展示在列表底部,使用push追加到数组末尾 conversationPageData.edges.push(newEdge); // 若最新消息展示在列表顶部,使用unshift插入到数组开头 // conversationPageData.edges.unshift(newEdge); // 同步更新pageInfo字段 // 若新消息在列表底部,将endCursor替换为新edge的游标 conversationPageData.pageInfo.endCursor = newEdge.cursor; // 若新消息在列表顶部,将startCursor替换为新edge的游标 // conversationPageData.pageInfo.startCursor = newEdge.cursor; // 因为已插入自己发送的最新消息,代表当前页已覆盖到会话最新条目,更新分页状态 conversationPageData.pageInfo.hasPreviousPage = false; }); cache.writeQuery({ query: CONVERSATION, data: newMessages }); }, });
常见注意事项
- 不要直接对
edges数组做整体赋值替换,否则会直接清掉当前页已加载的所有历史消息,只留新发送的单条内容 - 不需要修改
hasNextPage字段:该字段一般对应是否存在更早的历史消息,发送新消息不会改变历史消息的加载状态 - 新消息的游标值不需要严格匹配后端生成的游标规则,只要是和当前edge绑定的唯一位置标识即可,因为当前页已经把新消息纳入缓存范围,后续翻历史页时不会用到这条新消息的游标
- 乐观更新完成后,服务端返回真实消息数据时,Apollo会自动替换缓存中对应临时id的消息条目,不需要在update逻辑里做额外的id替换处理
内容的提问来源于stack exchange,提问作者Serenity
相关产品推荐
相关产品推荐

