spring.jpa.hibernate 配置和源码解析
版本
spring-boot:3.2.2
hibernate:6.4.1.Final
配置项目
DDL模式
生成定义语句修改表结构
- 配置路径：spring.jpa.hibernate.ddl-auto
- 配置值：org.hibernate.tool.schema.Action枚举类型值
可选值：
| 可选值 | 说明 |
|---|---|
| none | 默认值。不操作 |
| create-only | 当使用嵌入式数据库且没有模式管理器时，此项为默认值。创建，如果已存在将报错 |
| drop | 删除 |
| create | 删除后再创建 |
| create-drop | 先删除，SessionFactory启动时创建，SessionFactory关闭时再删除 |
| validate | 仅校验 |
| update | 必要时更新 |
| truncate | 清空数据 |
隐式命名策略
如果没有通过@Table或者@Column等注解显式指定表名、列名，将通过隐式命名策略生成对应名称
- 配置路径： spring.jpa.hibernate.naming.implicit-strategy
- 配置值：指定实现 org.hibernate.boot.model.naming.ImplicitNamingStrategy 接口的类全名
- 默认值： org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy
可选官方实现：
| 类名 | 说明 |
|---|---|
| org.hibernate.boot.model.naming.ImplicitNamingStrategyJpaCompliantImpl | 匹配JPA2.0标准的实现，使用JPA注解指派的名称或者根据类名属性名。其他实现都继承于此类。 |
| org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy | 默认值。重写了关联连接表名规则 |
| org.hibernate.boot.model.naming.ImplicitNamingStrategyComponentPathImpl | 重写了 AttributePath 转换规则，解析为完整路径 |
| org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyHbmImpl | 命名不依赖任何JPA注解 |
| org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl | 匹配JPA1.0标准的实现 |
物理命名策略
将显式指定或隐式命名策略转换得到的逻辑名称转换为数据库实际使用的物理名称
- 配置路径：spring.jpa.hibernate.naming.physical-strategy
- 配置值：指定实现 org.hibernate.boot.model.naming.PhysicalNamingStrategy 接口的类全名
- 默认值：org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy
可选官方实现：
| 类名 | 说明 |
|---|---|
| org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy | 将驼峰规则的命名转换为下划线规则 |
| org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl | 保持与逻辑名称一致，不做任何转换 |
源码
spring-boot-autoconfigure
org/springframework/boot/autoconfigure/orm/jpa/HibernateProperties.java
@ConfigurationProperties("spring.jpa.hibernate")
public class HibernateProperties {// 命名策略配置private final Naming naming = new Naming();// DDL模式配置private String ddlAuto;...// 读取DDL模式配置，按优先级读取配置或默认值private String determineDdlAuto(Map<String, String> existing, Supplier<String> defaultDdlAuto) {// 1. 获取hibernate.hbm2ddl.auto配置值String ddlAuto = existing.get(AvailableSettings.HBM2DDL_AUTO);if (ddlAuto != null) {return ddlAuto;}// 2. 获取spring.jpa.hibernate.ddl-auto配置值if (this.ddlAuto != null) {return this.ddlAuto;}// 3. 获取jakarta.persistence.schema-generation.database.action配置值if (existing.get(AvailableSettings.JAKARTA_HBM2DDL_DATABASE_ACTION) != null) {return null;}// 4. 默认为nullreturn defaultDdlAuto.get();}// 命名策略配置类public static class Naming {// 应用命名策略（没有配置属性则填充默认值）private void applyNamingStrategies(Map<String, Object> properties) {applyNamingStrategy(properties, AvailableSettings.IMPLICIT_NAMING_STRATEGY, this.implicitStrategy,() -> SpringImplicitNamingStrategy.class.getName());applyNamingStrategy(properties, AvailableSettings.PHYSICAL_NAMING_STRATEGY, this.physicalStrategy,() -> CamelCaseToUnderscoresNamingStrategy.class.getName());}...}...
}