如何让GraphQL返回MongoDB $geoNear聚合生成的distance字段？

问题核心原因 #

你之所以拿不到distance字段，是因为你的GraphQL类型定义（Schema）里没有声明这个字段。GraphQL是强类型的，只有在Type里定义过的字段，才会被包含在最终的响应结果里——哪怕MongoDB已经把distance返回给了解析器，GraphQL也会把它过滤掉。

解决步骤 #

1. 在GraphQL Schema中添加distance字段

找到你定义Shop类型的地方，把distance字段加进去。比如：

type Shop {
  _id: ID!
  name: String!
  location: Point! # 假设你已经有这个地理坐标字段
  # 新增distance字段，用Float类型存储精确数值，方便后续处理
  distance: Float!
}

2. 确认聚合查询的正确性

你当前的$geoNear聚合代码是完全没问题的：

findNearestShops: async ({ coordinates }) => Shop.aggregate([
  {
    $geoNear: {
      near: { type: 'Point', coordinates },
      distanceField: 'distance', // 这里指定了距离字段的名称
      minDistance: 0,
      maxDistance: 8046.72,
      spherical: true
    }
  }
]),

$geoNear作为聚合管道的第一个阶段，会自动把计算出的距离写入你指定的distanceField字段中，返回的每个结果对象都会包含这个字段——只是之前GraphQL没把它暴露出来而已。

3. 可选：添加格式化后的距离字段（比如“1.3米远”）

如果想直接返回友好的格式化字符串，可以在GraphQL类型里新增一个自定义字段，然后在解析器里处理：

• 先更新Schema：

type Shop {
  # 原有字段...
  distance: Float!
  formattedDistance: String! # 新增格式化后的距离字段
}

• 然后在Shop类型的解析器里添加这个字段的处理逻辑：

Shop: {
  formattedDistance: (parent) => {
    // parent就是聚合返回的单个Shop对象，自带distance字段
    return `${parent.distance.toFixed(1)}米远`;
  }
}

这样前端查询时直接请求formattedDistance就能拿到现成的友好字符串了。

补充：$near和$geoNear的区别 #

简单梳理下两者的核心差异：

• $near是普通查询操作，只能筛选出符合地理范围的文档并按距离排序，不会返回距离数值；
• $geoNear是聚合管道阶段，它不仅能完成$near的所有功能，还能主动计算并添加距离字段，而且后续还可以搭配$match、$project等其他聚合阶段，实现更复杂的数据处理逻辑。

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