Node.js调用Elasticsearch geo_distance 2km范围查询不生效问题

• 地理字段映射类型错误（最高发原因）
  geo_distance查询要求目标字段必须提前配置为geo_point类型。ES默认动态映射不会自动识别经纬度对象为地理点，会直接把location字段解析为包含lat、lon两个普通浮点数的对象字段，这种情况下地理距离计算逻辑根本不会生效，通常表现为返回空结果，部分版本会直接抛出类型异常。
  可以执行以下命令检查字段映射，确认类型是否正确：

  GET /products/_mapping/field/location
  

  如果返回的类型不是geo_point，无法直接修改已有字段类型，需要新建配置了正确映射的索引后重新全量导入数据。
• 经纬度参数值/顺序错误
  不同传参格式的geo_point对经纬度顺序要求不同：
  • 你代码里用的{lat: 纬度, lon: 经度}对象格式，顺序要求是纬度在前、经度在后，语法本身没问题，但要核对数值合法性和业务正确性：纬度合法范围是-90_{90，经度合法范围是-180}180。比如你如果要查询国内的地点，经度范围应该在73~135区间，你代码里写的经度31.96明显不在该区间，属于坐标值填错、经纬度值填反的情况，点位落在土耳其南部区域，自然匹配不到你预期的周边数据。
  • 如果数据入库时用数组格式存储geo_point，数组格式固定为[经度, 纬度]，如果写入时顺序写反，会导致所有点位坐标偏移到错误位置，无法被正确匹配。
• 查询语法兼容问题
  部分6.x及更早版本的ES对bool查询子句格式要求更严格，虽然新版本支持直接给filter、must传单个对象，但旧版本可能存在解析异常，可以统一改成数组写法（新版本完全兼容该写法，无副作用），调整后代码如下：

  await client
  .search({
    index: "products",
    query: {
      bool: {
        must: [
          { match_all: {} }
        ],
        filter: [
          {
            geo_distance: {
              distance: "2km",
              location: {
                lat: 36.561139369367346,
                lon: 31.96256160036761
              }
            }
          }
        ]
      }
    }
  })
  .then((res) => console.log("response", res))
  .catch((err) => console.log("err", err));
  

• 入库数据格式不合法
  如果写入数据时location字段传了不被geo_point识别的格式，比如顺序错误的经纬度字符串、空值、字段层级不匹配，会导致该条数据的地理字段未被正确索引，不会出现在地理查询的匹配结果里。

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