SpringBoot集成H2测试时Hibernate驼峰转下划线命名失效问题

• 项目基于Spring Boot 2.7.1开发，生产环境主数据库为MySQL，执行JUnit测试用例时采用H2内存数据库
• 参照Hibernate 5的SCHEMA级多租户方案实现了多租户能力，应用正常启动时多租户功能运行正常，配置的租户schema可正常创建
• 故障触发场景：使用Maven执行打包操作时部分测试用例执行失败，根因为Hibernate schema校验失败；即使手动关闭schema校验，运行时仍会抛出库表列不存在的异常

• 以实体类SessionActualValue为例，该类标注@Entity(name="my_actual_values")，包含actualValueName、measurementUnit等驼峰命名的实体字段，按照配置的命名策略本应自动转换为下划线格式的库表列名，但测试启动时抛出异常：

Caused by: org.hibernate.tool.schema.spi.SchemaManagementException: Schema-validation: missing column [actualValueName] in table [session_actual_values]

异常明确提示表中不存在驼峰格式的actualValueName列，说明驼峰转下划线的命名规则未生效

• 临时验证结果：给actualValueName字段添加@Column注解显式指定下划线列名后，该字段的报错消失，但会继续抛出下一个驼峰字段measurementUnit的同类缺失列错误，需要逐个字段添加注解才能解决，不符合预期
• 现有配置说明：
  • 主应用、测试环境的application.yml中均配置JPA隐式命名策略为org.hibernate.boot.model.naming.ImplicitNamingStrategyJpaCompliantImpl，物理命名策略为org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy
  • 测试环境配置H2方言，ddl-auto设为none并开启schema校验
  • 生产环境使用MySQL5InnoDBDialect，开启SCHEMA级多租户
• 现存问题：上述命名策略配置始终未生效，已准备好完整依赖配置、两份application.yml配置、实体类代码及完整错误栈用于排查

故障核心原因是 自定义多租户实现时的Hibernate Metadata构建逻辑未注入命名策略，且存在版本兼容性问题，按以下步骤修复即可：

1. 补全多租户模块的Hibernate配置
   参照Hibernate 5教程编写的SCHEMA级多租户逻辑，需要手动构建MetadataBuilder用于多租户schema初始化，这部分逻辑不会自动读取Spring配置文件中的JPA命名策略参数，需要在构建Metadata的代码段中手动注入命名策略：

   // 在你初始化多租户Metadata的代码位置补充以下配置
   metadataBuilder.applyImplicitNamingStrategy(ImplicitNamingStrategyJpaCompliantImpl.INSTANCE);
   metadataBuilder.applyPhysicalNamingStrategy(new SpringPhysicalNamingStrategy());
   

   Hibernate 6.x调整了Metadata构建的SPI逻辑，原Hibernate 5版本的多租户示例代码在Hibernate 6环境下运行时，会直接使用框架内置的默认命名策略，不会自动转换驼峰命名

2. 解决版本兼容性问题
   Spring Boot 2.7.1官方默认对齐的Hibernate版本为5.6.x，手动升级到hibernate-core 6.1.0.Final会导致Spring ORM模块的JPA自动配置逻辑不完全适配，二选一调整即可：
   • 方案A：将Hibernate版本回退到Spring Boot 2.7默认管理的5.6.10.Final，无需调整其他自动配置逻辑
   • 方案B：将Spring Boot版本升级到3.0.x及以上，该版本原生适配Hibernate 6.x系列
3. 修正测试环境配置
   测试环境当前设置ddl-auto: none依赖手动初始化的H2脚本，需要确认脚本中的列名、表名和命名策略生成的规则一致；如果不需要保留固定初始化脚本，可将测试环境的ddl-auto调整为create-drop，启动时自动按正确的命名策略生成表结构，避免手动维护脚本和实体字段不一致的问题
4. 修正实体类注解偏差
   @Entity(name="xxx")中的name属性为实体在JPQL中的名称，不是映射的数据库表名，指定表名需要单独添加@Table(name="my_actual_values")注解，避免Hibernate解析表映射时出现偏差。

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