MongoDB 2dsphere索引报错：嵌入文档含空数组location的问题

问题本质 #

你遇到的报错源于MongoDB的2dsphere索引对字段格式的严格要求：它要求数组必须是包含两个数值的经纬度对（[经度, 纬度]），而空数组[]不符合该格式。当文档中存在空数组的location字段时，整个文档会被索引验证拒绝，导致插入有效坐标的地址失败。

可行解决方案 #

1. 创建部分索引（Partial Index）

只对包含有效坐标的addresses.location字段建立2dsphere索引，空数组的文档不会被纳入索引范围，从而绕过验证。执行以下命令创建索引：

db.users.createIndex(
  { "addresses.location": "2dsphere" },
  { partialFilterExpression: { "addresses.location": { $type: "array", $size: 2 } } }
)

• 原理：partialFilterExpression指定只有当addresses.location是长度为2的数组时才创建索引，空数组或其他格式的字段不会触发索引验证。
• 优势：无需修改现有数据结构，地理查询只会匹配带有效坐标的地址，不影响业务逻辑。

2. 修改空坐标的存储方式

将空的location字段从空数组[]改为null，MongoDB的2dsphere索引会自动忽略null值的字段，既不影响保存，也能让有效坐标正常被索引。在Rails的Address模型中添加回调处理：

class Address
  include Mongoid::Document
  embedded_in :user
  field :location, type: Array

  before_save do
    self.location = nil if location.blank?
  end
end

• 原理：空数组被转换为null后，不会触发2dsphere索引的格式验证，有效坐标的数组则正常通过验证并被索引。
• 优势：改动小，只需调整模型逻辑，查询时依然可以正常筛选带有效坐标的文档。

3. 拆分地址模型（可选）

如果业务场景允许，将带地理坐标的地址和不带的地址拆分为两个嵌入关联：

class User
  include Mongoid::Document
  embeds_many :addresses # 不带地理坐标的普通地址
  embeds_many :geocoded_addresses # 带地理坐标的地址
end

class GeocodedAddress
  include Mongoid::Document
  embedded_in :user
  field :location, type: Array
end

然后仅给geocoded_addresses.location创建2dsphere索引：

db.users.createIndex({ "geocoded_addresses.location": "2dsphere" })

• 原理：分离两种地址类型，索引只作用于带坐标的地址集合，彻底避免格式冲突。
• 注意：需要调整业务逻辑，区分处理两种地址类型，适合对地址分类有明确需求的场景。

地理查询示例 #

无论采用哪种方案，地理空间查询都可以正常执行，例如查找距离指定坐标10公里内的用户：

db.users.find({
  "addresses.location": {
    $near: {
      $geometry: { type: "Point", coordinates: [12.77, 85.899] },
      $maxDistance: 10000
    }
  }
})

查询只会匹配包含有效坐标的地址文档，空值或空数组的地址不会被纳入结果。

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