导出Jar后Hibernate Search初始化失败：协调策略Bean缺失

以下是针对你遇到的问题的排查方向和解决方法：

1. 检查Maven打包时的依赖完整性 #

本地运行正常但Jar包异常，大概率是打包过程中丢失了Hibernate Search的关键依赖或配置文件：

• 确认hibernate-search-mapper-orm-orm6、hibernate-search-backend-lucene的依赖范围为compile（默认即为compile，除非手动修改），且未被其他依赖排除：

  <dependency>
      <groupId>org.hibernate.search</groupId>
      <artifactId>hibernate-search-mapper-orm-orm6</artifactId>
      <version>6.1.7.Final</version>
  </dependency>
  <dependency>
      <groupId>org.hibernate.search</groupId>
      <artifactId>hibernate-search-backend-lucene</artifactId>
      <version>6.1.7.Final</version>
  </dependency>
  

• 如果使用spring-boot-maven-plugin打包，确保没有通过<exclusions>排除上述依赖；如果使用maven-shade-plugin或maven-assembly-plugin，需配置插件包含所有必要的依赖Jar。

2. 修复服务加载器配置文件的合并问题 #

Hibernate Search通过Java ServiceLoader机制加载Bean定义，打包时如果未合并META-INF/services下的配置文件，会导致无法找到'none'策略的Bean实现：

• 若使用maven-shade-plugin，添加ServicesResourceTransformer来合并服务配置文件：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.4.1</version>
      <executions>
          <execution>
              <phase>package</phase>
              <goals>
                  <goal>shade</goal>
              </goals>
              <configuration>
                  <transformers>
                      <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                      <!-- 其他transformer配置 -->
                  </transformers>
              </configuration>
          </execution>
      </executions>
  </plugin>
  

• 若为Spring Boot项目，默认打包插件会自动处理服务文件合并，但如果自定义了打包逻辑，需确保META-INF/services/org.hibernate.search.engine.environment.bean.spi.BeanConfigurer文件被包含在最终Jar中。

3. 统一Hibernate ORM与Search的版本 #

你当前使用Hibernate ORM 6.1.3和Hibernate Search 6.1.7，虽官方宣称6.1.x系列兼容，但小版本差异可能导致Bean注册逻辑不匹配：

• 将Hibernate ORM版本升级至6.1.7.Final，保持与Hibernate Search版本一致，避免版本兼容问题：

  <dependency>
      <groupId>org.hibernate.orm</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>6.1.7.Final</version>
  </dependency>
  

4. 验证运行时配置属性 #

确认Jar运行时加载的配置中，hibernate.search.coordination.strategy的实际值：

• 在应用启动时添加日志打印，输出Hibernate的配置属性，检查是否存在配置源冲突（比如系统属性、环境变量覆盖了配置文件中的设置）；
• 若未显式配置该属性，可尝试在配置文件中显式声明hibernate.search.coordination.strategy=none，确保Hibernate Search加载默认策略。

额外排查步骤 #

• 解压生成的Jar包，检查BOOT-INF/lib（Spring Boot项目）或根目录下是否包含hibernate-search-mapper-orm-orm6-6.1.7.Final.jar和hibernate-search-backend-lucene-6.1.7.Final.jar；
• 检查Jar包内是否存在META-INF/services/org.hibernate.search.engine.environment.bean.spi.BeanConfigurer文件，且文件内容包含org.hibernate.search.mapper.orm.coordination.impl.NoOpCoordinationStrategyBeanConfigurer（'none'策略的配置类）。

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