Hibernate Search 6.2.0.Alpha2嵌套JAR索引创建失败求助

问题根源 #

你遇到的错误确实和HSEARCH-4724的修复相关——该修复优化了Jandex索引的加载性能，但在Spring Boot Fat Jar这类嵌套JAR场景下，新引入的ZIP文件系统访问逻辑存在兼容性问题，导致无法读取嵌套JAR内的索引文件。

解决方法 #

1. 强制禁用ZIP文件系统加载（临时方案） #

添加JVM启动参数，强制Hibernate Search使用传统方式读取Jandex索引：

-Dhibernate.search.mapping.jandex.use_zip_file_system=false

这个参数会跳过新的ZIP文件系统逻辑，回退到之前的索引读取方式，快速绕过当前问题。

2. 排查并统一Jandex依赖版本 #

检查项目中org.jboss:jandex的依赖版本，确保和Hibernate Search 6.2.0.Alpha2的依赖版本一致：

• Maven项目执行mvn dependency:tree，Gradle项目执行./gradlew dependencies，查看Jandex的版本。
• 如果存在版本冲突，在依赖管理中明确指定兼容版本（比如Hibernate Search 6.2.0.Alpha2对应的Jandex版本为2.4.2.Final）。

3. 手动指定Jandex索引路径 #

在Spring Boot配置文件（application.properties或application.yml）中，明确指定需要加载的Jandex索引文件路径，避免自动扫描嵌套JAR时出错：

# application.properties
hibernate.search.mapping.jandex.indexes=classpath:/META-INF/jandex.idx,classpath:/META-INF/security-persistence-plain.jandex.idx

4. 等待官方修复 #

由于问题是Alpha版本的兼容性问题，Hibernate Search团队会在后续Alpha版本或正式版中修复该嵌套JAR场景的bug，可关注项目迭代更新。

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