Hibernate Search索引命名异常及数据覆盖问题排查与解决

问题背景 #

• 技术栈：集成Hibernate Search（6.2.2.Final）的Spring应用，Docker部署Elasticsearch 8.9.1、Enterprise Search及Kibana
• 核心异常：索引自定义FileEntityHS实体时，Hibernate Search自动生成带-000001后缀的新索引（如search-fileentity-new-000001），不使用预先创建的指定索引；调整生命周期配置无效，改用MassIndexer时触发MySQL持久化异常

排查与解决过程 #

阶段1：修复索引命名，但数据覆盖仍存在 #

• 排查确认：不是索引重建，而是已有数据被覆盖
• 配置调整：将hibernate.search.backend.layout.strategy设置为no-alias，索引命名恢复正常，但数据覆盖问题未解决

阶段2：定位根因并彻底解决 #

• 核心问题：索引文档ID始终固定为0，导致新数据不断覆盖旧数据
• 解决方案：将实体ID类型改为String，并在构造函数中通过UUID或fileGuid手动赋值，实现数据独立索引，不再出现覆盖情况

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