GraphCms GraphQL查询image.url返回null/空字符串报错排查

报错核心是GraphCMS服务端实际收到的查询请求中，image字段没有配置子字段选择集，不符合GraphQL的语法要求：image是Asset!非空对象类型，查询时必须明确声明需要返回的子字段，不能直接查询对象字段本身。
你本地编写的GraphQL查询语法本身是正确的，出现这个报错的根本原因是实际发起请求的代码和你本地看到的查询语句不一致，和Asset资源发布状态无关，常见触发场景：

• 项目使用的GraphQL代码生成工具（如GraphQL Code Generator）未重新执行，useGetProductsQuery钩子对应的是旧版本查询——旧查询中仅声明了image字段未加{ url }子字段，导致发出的请求不符合语法要求，服务端直接返回错误，data字段为null，你自然无法读取到image.url的值。
• 本地开发服务/构建工具存在缓存，复用了旧版本的查询逻辑，没有同步你最新修改的查询语句。

按照以下步骤逐一排查修复即可：

1. 重新执行GraphQL代码生成命令
   找到项目package.json中配置的codegen对应脚本，一般为codegen，在项目根目录执行对应命令重新生成请求钩子和类型定义：

   # npm 环境
   npm run codegen
   # yarn 环境
   yarn codegen
   # pnpm 环境
   pnpm codegen
   

   生成完成后打开../../graphql/generated目录下的生成文件，检查GetProductsQuery对应的类型定义，确认products数组元素下的image类型包含url字段，证明新的查询已经被正确生成。
2. 清除本地缓存重启服务
   删除项目下的构建缓存目录（如.next、dist、node_modules/.cache），重启本地开发服务，避免旧的查询逻辑被缓存复用。
3. 校验实际发出的请求内容
   打开浏览器开发者工具的网络面板，筛选发往GraphCMS接口的请求，检查请求载荷中的query字段，确认实际发出的查询中image字段后确实携带了{ url }子字段选择，和你本地编写的查询一致。

补充说明：你观察到的返回值为null/空字符串，本质是请求报错后data整体为null，代码中使用了可选链data?.products所以没有直接抛出JS运行时错误，并非接口返回的image.url本身为空。你已经确认关联Asset均已发布，无需再排查资源发布配置。

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