KeystoneJS中Mongoose适配器实现MongoDB $nearSphere附近搜索及聚合查询的问题

• 前置校验：确认自定义Location字段的存储结构合规
  基于@keystonejs/fields-location-google修改的自定义字段，必须保证最终写入数据库的坐标是标准GeoJSON Point格式：{ type: "Point", coordinates: [lng, lat] }，特别注意数组内顺序是经度在前、纬度在后，顺序颠倒会直接触发MongoDB的GeoJSON格式校验错误，哪怕参数结构看起来对也会查询失败。
• 必备步骤：手动挂载2dsphere地理空间索引
  KeystoneJS默认不会为自定义Location字段自动创建地理空间索引，没有索引的前提下运行$nearSphere查询，会直接抛出“缺少地理空间索引”的运行时错误。需要在对应List初始化完成后，拿到关联的Mongoose collection实例，调用原生的createIndex方法，为存储GeoJSON的字段配置2dsphere类型索引。
• 自定义GraphQL查询的参数适配
  不要直接通过Keystone默认的Mongoose适配器find方法透传$nearSphere操作符，Keystone的默认查询逻辑会对传入参数做白名单过滤，自定义的MongoDB操作符会被直接拦截清空，导致查询条件完全失效。
  正确实现路径：在自定义GraphQL resolver中，获取当前List对应的原生Mongoose模型实例，直接调用模型原生的find方法，传入经过格式校验的$nearSphere查询条件，同时将计算得出的距离值作为附加字段挂载到返回结果中。
• 复杂场景的聚合查询实现
  如果需要按距离排序、按服务半径过滤、关联距离计算的复杂需求，直接绕开Keystone默认的聚合封装，使用原生Mongoose模型调用aggregate方法，按照MongoDB地理空间聚合的标准管道逻辑编写查询：首先通过$geoNear管道阶段传入查询中心点坐标、最大匹配距离、距离字段输出名等核心参数，再接后续的筛选、分页、字段裁剪管道即可完成查询。
• 常见报错排查方向
  • 检查coordinates数组的坐标顺序，禁止将纬度放在数组第一位
  • 检查已创建的索引类型，确保是2dsphere而非普通2d索引，二者对球面查询的兼容性不同
  • 排查Keystone参数过滤逻辑对自定义操作符的拦截，被拦截的查询参数不会传入底层Mongoose执行层

内容的提问来源于stack exchange，提问作者Muhad B K