spring.jpa.hibernate 配置和源码解析

版本

spring-boot:3.2.2
hibernate:6.4.1.Final

配置项目

DDL模式

生成定义语句修改表结构

• 配置路径：spring.jpa.hibernate.ddl-auto
• 配置值：org.hibernate.tool.schema.Action枚举类型值

可选值：

隐式命名策略

如果没有通过@Table或者@Column等注解显式指定表名、列名，将通过隐式命名策略生成对应名称

• 配置路径： spring.jpa.hibernate.naming.implicit-strategy
• 配置值：指定实现 org.hibernate.boot.model.naming.ImplicitNamingStrategy 接口的类全名
• 默认值： org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy

可选官方实现：

物理命名策略

将显式指定或隐式命名策略转换得到的逻辑名称转换为数据库实际使用的物理名称

• 配置路径：spring.jpa.hibernate.naming.physical-strategy
• 配置值：指定实现 org.hibernate.boot.model.naming.PhysicalNamingStrategy 接口的类全名
• 默认值：org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy

可选官方实现：

源码

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. 默认为null
		return 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());
		}
		...
	}
	...
}