express-graphql+Apollo栈GraphQL查询报错但功能正常排查求助

问题根因分析 #

你当前贴出的前端查询语句和后端ScanArea类型定义是完全匹配的，且业务功能正常，说明报错是其他非预期的GraphQL查询请求触发的服务端校验错误，和你正常使用的查询无关。
从报错信息可以反推触发错误的查询结构大致如下：

query WrongQuery {
  scanAreas {
    type
    properties # 第4行，对应报错：ScanArea上不存在properties字段
    geometry # 第5行，对应报错：ScanArea上不存在geometry字段
    features # 第6行，对应报错：列表类型features未指定子字段
  }
}

可能的触发场景 #

• 前端存在遗留的错误查询代码：其他业务模块/历史版本中写了不符合Schema的ScanArea查询，没有嵌套到features层级中就直接请求了properties、geometry字段
• 生产环境存在旧版前端缓存：部分用户未刷新页面，仍在运行上线修复前的旧版本JS代码，持续发送错误查询
• 爬虫/恶意请求：外部攻击者或爬虫尝试构造无效查询请求访问你的GraphQL接口，触发服务端校验报错
• 多实例部署残留旧版本：服务端部署时存在部分实例未更新，仍运行着旧版的Schema定义，收到合法查询时也会报错
• Apollo客户端缓存异常：开启了持久化查询的情况下，旧的错误查询ID仍被客户端缓存调用

排查步骤 #

1. 先给express-graphql中间件添加请求日志，打印所有入站请求的query内容、用户UA、来源IP，确认触发报错的请求的具体查询内容，确认是否和你贴出的合法查询一致
2. 全量检索前端代码库中所有gql标签包裹的查询语句，排查是否存在其他查询scanAreas的错误写法
3. 检查生产环境CDN/静态资源缓存配置，确认是否有旧版本的前端JS资源仍可被访问，推送新资源时是否配置了合理的缓存失效策略
4. 核对所有生产环境服务实例的代码版本，确认Schema定义都是最新的，没有旧版本残留
5. 若排查后确认是外部恶意请求触发，可开启GraphQL查询白名单，只放行前端实际用到的查询，同时添加查询复杂度/深度校验拦截无效请求

内容的提问来源于stack exchange，提问作者Derick M.