Laravel集成Elasticsearch报resource_already_exists_exception异常

报错根因 #

异常提示resource_already_exists_exception的触发逻辑非常明确：你写在/search路由里的Post::createIndex()是无条件执行的，第一次访问路由时posts索引就已经创建完成，后续每次访问路由都会重复发起创建同名索引的请求，Elasticsearch不允许重复创建同名索引，直接返回400错误。

修复步骤 #

• 第一步：清理已存在的旧索引
  任选一种方式执行即可：
  • 命令行直接调用ES接口删除：执行 curl -XDELETE http://localhost:9200/posts
  • 临时在路由代码最开头加Post::deleteIndex();，访问一次路由完成删除后立刻删掉这行代码
• 第二步：调整路由逻辑，增加索引存在性判断
  索引创建、映射配置属于一次性初始化操作，不需要每次访问路由都执行，修改后的路由代码参考：

Route::get('/search', function () {
    // 仅当索引不存在时才执行创建、映射配置操作
    if (!Post::indexExists()) {
        Post::createIndex($shards = null, $replicas = null);
        Post::putMapping($ignoreConflicts = true);
    }

    Post::addAllToIndex();
});

后续优化建议 #

• 不要把索引初始化、全量数据导入这类重操作放在web路由中：这类操作执行耗时长，用户访问时很容易触发PHP超时、ES请求超时问题，建议封装成独立的Artisan命令，需要初始化/全量同步的时候手动在命令行执行。
• 日常业务运行中不要每次访问都执行全量数据同步：建议配合模型事件做增量索引同步，数据写入、更新、删除时自动同步对应文档到ES，避免每次全量拉取表数据带来的性能损耗。
• 后续如果要调整字段映射，不要直接修改已有索引的配置：Elasticsearch不支持直接修改已存在字段的映射类型，正确流程是创建新版本索引、完成数据同步后通过别名切换指向新索引，避免业务中断。

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