如何用Relay、GraphQL、React渲染数据?Django GraphQL拉取key警告
报错根因修复
触发React列表key警告的核心原因是代码解构数据的路径错误,导致绑定到列表项的key值全部为undefined,无法满足React对列表子元素的唯一标识要求。
Django生态主流的GraphQL实现Graphene,返回的连接类分页数据有固定结构:
{ "allEmployers": { "edges": [ { "cursor": "服务端为每条记录生成的唯一游标", "node": { "id": "对象全局唯一ID", "employerName": "雇主名称", "email": "联系邮箱", "phone": "联系电话" } } ] } }
当前代码的map逻辑直接从edge层级解构id、employerName等字段,没有进入内层的node对象取值,实际拿到的id为undefined,所有列表项的key值重复,因此触发渲染警告。
修复方案
调整map的解构逻辑,从edge.node层级取所有业务字段:
export function EmployerInfo() { const { data, loading } = useQuery(QUERY_EMPLOYERS, {pollInterval: 500}); if (loading) return <p>Loading...</p>; return data?.allEmployers.edges.map(({ node: { id, employerName, email, phone } }) => ( <div key={id}> <p> Employer - { employerName } { email } { phone } </p> </div> )); }
如果遇到服务端返回的node.id重复的异常场景,可以直接使用edge自带的cursor作为key值,因为cursor本身就是服务端为每条记录生成的全局唯一标识,适配性更强:
return data?.allEmployers.edges.map(({ cursor, node: { employerName, email, phone } }) => ( <div key={cursor}> <p> Employer - { employerName } { email } { phone } </p> </div> ));
Relay、GraphQL与React的协同渲染流程
- 后端适配:基于Django搭建GraphQL服务时,需为业务模型实现Relay兼容的Node接口,自动生成全局唯一节点ID、符合规范的连接分页结构,保证前端拿到的数据结构无需二次适配即可被Relay识别。
- 客户端配置:前端接入Relay时,需初始化Relay环境关联后端GraphQL接口,编写带GraphQL片段定义的查询语句,通过
useLazyLoadQuery、useFragment等官方Hooks在组件中获取数据。 - 列表渲染规范:无论使用Apollo Client还是Relay拉取GraphQL列表数据,必须为每个列表项绑定服务端返回的全局唯一值(节点ID、分页游标)作为
key属性,禁止使用数组索引作为key,避免数据轮询更新时出现渲染异常、key值冲突的问题。
内容的提问来源于stack exchange,提问作者Raymond Kipngetich
相关产品推荐
相关产品推荐

