使用NestJS与Mongoose时遭遇$geoNear查询索引缺失错误

问题场景 #

使用NestJS结合Mongoose开发时，调用地理空间查询接口（使用$near操作符）持续收到错误提示：unable to find index for $geoNear query。尝试在Service中调用this.locationModel.createIndexes({ location: "2dsphere" })手动创建索引，但问题依旧。

核心原因 #

1. 索引定义时机与位置错误：在Service中临时调用createIndexes属于异步操作，查询可能先于索引创建完成执行；且TypeScript的Location接口仅做类型校验，不会影响MongoDB的实际索引配置。
2. 缺失Schema层面的索引声明：地理空间索引必须在Mongoose的Schema中明确定义，才能让MongoDB正确识别并创建对应索引。

解决方案 #

1. 创建并配置Location Schema #

新增location.schema.ts文件，在Schema中明确声明location字段为Point类型，并添加2dsphere索引：

import { Schema } from 'mongoose';

export const LocationSchema = new Schema({
  description: String,
  city: String,
  state: String,
  location: {
    type: {
      type: String,
      enum: ['Point'],
      required: true,
    },
    coordinates: {
      type: [Number],
      required: true,
    },
  },
});

// 注册2dsphere地理空间索引
LocationSchema.index({ location: '2dsphere' });

2. 关联Schema与Module #

在对应Module中，将Schema注册到Mongoose：

import { Module } from '@nestjs/common';
import { MongooseModule } from '@nestjs/mongoose';
import { LocationService } from './location.service';
import { LocationSchema } from './location.schema';

@Module({
  imports: [
    MongooseModule.forFeature([{ name: 'Location', schema: LocationSchema }]),
  ],
  providers: [LocationService],
})
export class LocationModule {}

3. 简化Service查询代码 #

此时无需在Service中手动调用createIndexes，Mongoose会在数据库连接初始化时自动创建索引（开发环境默认开启autoIndex，生产环境建议手动创建索引后关闭该选项）：

import { Injectable } from "@nestjs/common";
import { InjectModel } from "@nestjs/mongoose";
import { Model } from "mongoose";
import { Location } from "src/types/location";

@Injectable()
export class LocationService {
  constructor(
    @InjectModel("Location") private locationModel: Model<Location>
  ) {}

  async getNearbyLocations(lon: number, lat: number, pageSize: number, pageNum: number) {
    const skip = (pageNum - 1) * pageSize;
    const locations = await this.locationModel
      .find({
        location: {
          $near: {
            $geometry: { type: "Point", coordinates: [lon, lat] },
            $minDistance: 0,
            $maxDistance: 20000,
          },
        },
      })
      .skip(skip)
      .limit(pageSize);
    return locations;
  }
}

4. 验证索引有效性 #

通过MongoDB Shell执行以下命令，检查索引是否成功创建：

db.locations.getIndexes()

若输出结果中包含{ "location" : "2dsphere" }的索引项，则说明配置生效。

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