Lucene迁移至Elasticsearch：Hibernate Search部署故障及数据填充方式咨询

首先咱们先定位部署失败的直接根源：从错误日志里能看到，你的Elasticsearch集群状态是yellow，而Hibernate Search在启动时发送了等待集群状态变为green的请求，最终超时（408 Request Timeout）导致部署失败。

为什么集群是yellow状态？ #

你的ES是单节点集群（number_of_nodes: 1），但Elasticsearch默认会给每个索引创建1个主分片+1个副本分片。单节点环境下，副本分片没办法分配到其他节点，所以一直处于未分配状态（unassigned_shards: 5），集群也就停留在yellow状态。而Hibernate Search默认要求启动时集群必须达到green状态，这就触发了超时错误。

第一步：解决集群状态超时问题 #

你有两种可选方案：

• 方案一：修改Elasticsearch的副本配置
  直接在ES中执行命令，将现有索引和新索引的副本数改为0（单节点不需要副本）：

  # 修改所有现有索引的副本数
  PUT /*/_settings
  {
    "number_of_replicas": 0
  }
  # 设置全局模板，让新创建的索引默认副本数为0
  PUT /_template/default
  {
    "index_patterns": ["*"],
    "settings": {
      "number_of_replicas": 0
    }
  }
  

  执行后集群会快速切换为green状态。

• 方案二：调整Hibernate Search的集群健康等待策略
  在persistence.xml中添加配置，允许Hibernate Search在集群处于yellow状态时继续启动，同时可适当延长超时时间：

  <property name="hibernate.search.default.elasticsearch.health.wait_for_status" value="yellow"/>
  <property name="hibernate.search.default.elasticsearch.health.timeout" value="30000ms"/>
  

第二步：关于数据填充的问题 #

Hibernate Search 不会自动同步MySQL中已有的历史数据到Elasticsearch，它只会同步应用部署后，通过Hibernate ORM新增/修改/删除的数据。所以要把MySQL里的存量数据导入ES，你需要手动触发索引重建：

可以在应用启动成功后，通过API执行重建操作：

FullTextEntityManager fullTextEntityManager = Search.getFullTextEntityManager(entityManager);
// 异步执行重建，也可以用startAndWait()同步等待完成
fullTextEntityManager.createIndexer().start();

不建议在生产环境通过配置自动触发重建，会拖慢应用启动速度，更稳妥的方式是启动后手动调用重建逻辑。

额外检查点 #

1. 依赖版本兼容性：你使用的Hibernate Search Elasticsearch 5.11.8.Final和Elasticsearch 5.6.16是兼容的（Hibernate Search 5.11.x官方支持ES 5.6.x版本），这部分无需调整。
2. 明文密码警告：日志里的HSEARCH400073只是安全提示，因为你用HTTP传输密码，生产环境建议改用HTTPS，但这不是部署失败的原因。

完整部署流程建议 #

1. 先处理Elasticsearch集群的yellow状态（二选一修改副本配置或Hibernate Search等待策略）。
2. 部署应用，此时Hibernate Search会自动创建索引结构（因为你设置了drop-and-create的schema管理策略）。
3. 应用启动成功后，手动触发索引重建，同步MySQL存量数据到Elasticsearch。

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