Hibernate Search Outbox Polling无法创建表及不识别手动表问题

• 版本不兼容（核心问题）
  你使用的Hibernate Search核心版本是6.1.8.Final，但Outbox Polling用了7.1.1.Final，跨大版本的组件完全不兼容。Hibernate Search的所有组件版本必须严格匹配：6.x系列对应6.x的Outbox Polling，7.x对应7.x。Spring Boot 3.0.1默认依赖Hibernate Search 6.1.x，建议将Outbox Polling版本改成6.1.8.Final，或者升级Spring Boot到3.2+来适配Hibernate Search 7.x。

• 依赖引入是否正确
  确保引入了对应版本的Spring Boot Starter依赖，而非普通jar包。6.1.x版本的依赖配置如下（Maven）：

  <dependency>
      <groupId>org.hibernate.search</groupId>
      <artifactId>hibernate-search-mapper-orm-coordination-outbox-polling-spring-boot-starter</artifactId>
      <version>6.1.8.Final</version>
  </dependency>
  

  Gradle项目对应调整依赖声明即可。

• 配置加载有效性检查
  确认Spring配置模块的application.properties被主模块正确读取：

  • 检查配置模块是否是主模块的compile/runtime依赖
  • 验证主模块的@SpringBootApplication注解是否覆盖了配置模块的包路径，或是否通过@PropertySource手动引入了配置文件
  • 开启调试日志logging.level.org.hibernate.search=DEBUG，查看启动时Hibernate Search是否读取到hibernate.search.coordination.strategy=outbox-polling配置

• 自动建表配置验证
  检查Hibernate的DDL自动生成开关：在application.properties中设置spring.jpa.hibernate.ddl-auto=update（调试阶段使用，生产环境建议用Flyway/Liquibase管理）。如果之前设置为none，Hibernate不会自动创建Outbox Polling所需的HSEARCH_*系列表。

• 实体索引配置正确性
  需要索引的实体必须满足以下条件：

  • 类上添加@Indexed注解
  • 需要被索引的字段添加@FullTextField、@KeywordField等注解
  • 实体主键需配置@Id和合法的主键生成策略（如@GeneratedValue），Outbox Polling依赖主键跟踪实体变更

• 手动建表的结构匹配问题
  若用Flyway手动建表，必须保证表结构与Hibernate Search 6.1.8.Final的官方定义完全一致——6.x和7.x版本的表结构差异很大，结构不匹配会导致无法插入事件数据。可以从对应版本的官方文档中获取标准DDL语句，对比你手动创建的表是否一致。

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