Elasticsearch 2.3版本操作geo_point字段时传入字符串或对象格式均报错问题求助

错误1：mapper_parsing_exception（字符串格式坐标触发类型冲突） #

错误原因分析 #

从错误日志里的Mixing up field types: StringFieldType != GeoPointFieldType on field location可以看出，你的location字段在索引中已经被标记为字符串类型，但后续你将映射修改为geo_point类型。Elasticsearch的字段类型一旦由首次写入的文档确定（或手动创建映射后），就无法直接修改，强行写入不同类型的数据就会触发这个冲突。

另外，虽然Elasticsearch 2.3的geo_point支持逗号分隔的字符串格式（格式为"纬度,经度"），但如果字段已经被错误映射为字符串，这个格式会被当成普通字符串处理，而非地理坐标。

修复步骤 #

• 确认索引映射状态：先检查当前users索引的映射，确认location字段的实际类型：

  const { body: mapping } = await client.indices.getMapping({
    index: 'users'
  });
  console.log(mapping.users.mappings.user.properties.location);
  

• 重建索引（如果字段类型确实冲突）：
  1. 创建一个新的临时索引（比如users_new），设置正确的映射，确保location为geo_point类型：

     await client.indices.create({
       index: 'users_new',
       body: {
         mappings: {
           user: {
             // 复制你原有的完整映射，确保location.type是geo_point
             properties: {
               // ... 其他字段
               "location": { "type": "geo_point" }
             }
           }
         }
       }
     });
     

  2. 将旧索引的数据迁移到新索引：

     await client.reindex({
       body: {
         source: { index: 'users' },
         dest: { index: 'users_new' }
       }
     });
     

  3. 删除旧索引，将新索引重命名为原索引名：

     await client.indices.delete({ index: 'users' });
     await client.indices.putAlias({
       index: 'users_new',
       name: 'users'
     });
     

• 确保写入的字符串坐标格式正确：如果要使用字符串格式，必须严格遵循"纬度,经度"的顺序，比如"41.00445520431176,28.976772329847574"是符合要求的，但前提是字段类型已经正确设置为geo_point。

错误2：invalid_type_name_exception（对象格式坐标触发类型名错误） #

错误原因分析 #

这个错误和geo_point格式无关，而是因为你使用了错误的文档类型路径。Elasticsearch 2.3仍然使用文档类型（Type）的概念，而_doc是Elasticsearch 7.x及以后版本的默认类型名，在2.3版本中，类型名称不能以_开头。从你的请求路径/users/_doc和映射里的user类型可以看出，你应该使用user作为类型名，而非_doc。

修复步骤 #

修改Node.js客户端的写入请求，将类型指定为user，而非_doc：

// 错误的写法（使用了_doc类型）
await client.index({
  index: 'users',
  type: '_doc', // 这里出错了
  body: {
    location: { lat: 41.12, lon: -71.34 },
    // ... 其他字段
  }
});

// 正确的写法（使用映射里定义的user类型）
await client.index({
  index: 'users',
  type: 'user', // 匹配你的映射中的类型
  body: {
    location: { lat: 41.12, lon: -71.34 },
    // ... 其他字段
  }
});

这样就能避免Document mapping type name can't start with '_'的错误，同时对象格式的geo_point也能被正确解析。

额外注意事项 #

• Elasticsearch 2.3是非常老旧的版本（发布于2016年），存在很多已知的安全漏洞和功能限制，建议尽量升级到更高版本（比如7.x或8.x），不过如果受限于环境无法升级，需要严格遵循2.3的文档规范。
• 使用Node.js客户端时，要确保客户端版本和Elasticsearch版本兼容：Elasticsearch 2.3对应的官方Node.js客户端版本应该是^13.0.0（因为客户端版本号从13.x开始对应ES 2.x），Node.js 14虽然可以运行这个版本，但可能存在一些兼容性警告，建议测试确认。

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