如何修改Grails 5应用中Spring Boot使用的Physical Naming策略

为什么需要修改底层命名策略？ #

当你在Grails应用中直接使用Hibernate原生API，或者集成Envers这类基于Hibernate的库时，这些组件是通过Spring Boot的JPA初始化流程启动的，完全绕开了Gorm的命名策略逻辑。此时Hibernate会默认使用PhysicalNamingStrategyStandardImpl，导致生成的表/列命名和Gorm的规则不一致（比如Gorm用蛇形命名，Hibernate原生用驼峰），进而出现表不存在、字段不匹配的错误。

另外你提到的「自定义策略被默认策略二次处理」的问题，本质是Gorm的命名策略只负责自身的映射处理，而Spring Boot的Hibernate自动配置会独立设置底层物理命名策略，两者是两套并行的逻辑，所以会出现先过自定义策略、再被默认策略覆盖的情况。

常规配置无效时的解决方法 #

如果spring.jpa.hibernate.naming.physical-strategy这类常规配置属性不生效，可以通过以下编程式方式强制替换默认策略：

方法1：实现HibernatePropertiesCustomizer #

通过Spring的HibernatePropertiesCustomizer接口，在Hibernate配置初始化时手动注入自定义策略：

import org.hibernate.boot.model.naming.PhysicalNamingStrategy
import org.springframework.boot.autoconfigure.orm.jpa.HibernatePropertiesCustomizer
import org.springframework.stereotype.Component

@Component
class CustomNamingStrategyCustomizer implements HibernatePropertiesCustomizer {

    private final PhysicalNamingStrategy customStrategy

    // 注入你自己实现的PhysicalNamingStrategy实例
    CustomNamingStrategyCustomizer(PhysicalNamingStrategy customStrategy) {
        this.customStrategy = customStrategy
    }

    @Override
    void customize(Map<String, Object> hibernateProperties) {
        // 强制覆盖底层物理命名策略
        hibernateProperties.put("hibernate.physical_naming_strategy", customStrategy)
    }
}

方法2：直接接管EntityManagerFactory配置 #

如果上面的方式仍不生效，可以完全自定义LocalContainerEntityManagerFactoryBean，绕过Spring Boot的默认配置：

import org.hibernate.boot.model.naming.PhysicalNamingStrategy
import org.springframework.boot.autoconfigure.orm.jpa.JpaProperties
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean
import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter

@Configuration
class HibernateNamingConfig {

    @Bean
    LocalContainerEntityManagerFactoryBean entityManagerFactory(
            DataSource dataSource,
            JpaProperties jpaProperties,
            PhysicalNamingStrategy customStrategy) {

        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean()
        em.setDataSource(dataSource)
        em.setPackagesToScan("com.your.app.domain") // 替换为你的领域类包路径

        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter()
        em.setJpaVendorAdapter(vendorAdapter)

        // 合并原有JPA配置并覆盖命名策略
        Map<String, Object> properties = new HashMap<>(jpaProperties.getProperties())
        properties.put("hibernate.physical_naming_strategy", customStrategy)
        em.setJpaPropertyMap(properties)

        return em
    }
}

方法3：统一Gorm与Hibernate的策略实现 #

为了避免两套策略逻辑不一致，让你的Gorm自定义命名策略同时实现Hibernate的PhysicalNamingStrategy接口，这样可以复用同一个规则：

import org.hibernate.boot.model.naming.Identifier
import org.hibernate.boot.model.naming.PhysicalNamingStrategy
import org.hibernate.engine.jdbc.env.spi.JdbcEnvironment

class UnifiedSnakeCaseNamingStrategy implements PhysicalNamingStrategy {

    @Override
    Identifier toPhysicalCatalogName(Identifier name, JdbcEnvironment jdbcEnv) {
        convertToSnakeCase(name)
    }

    @Override
    Identifier toPhysicalSchemaName(Identifier name, JdbcEnvironment jdbcEnv) {
        convertToSnakeCase(name)
    }

    @Override
    Identifier toPhysicalTableName(Identifier name, JdbcEnvironment jdbcEnv) {
        convertToSnakeCase(name)
    }

    @Override
    Identifier toPhysicalColumnName(Identifier name, JdbcEnvironment jdbcEnv) {
        convertToSnakeCase(name)
    }

    private Identifier convertToSnakeCase(Identifier name) {
        if (!name) return null
        String snakeCase = name.getText()
                .replaceAll("([a-z])([A-Z])", "$1_$2")
                .toLowerCase()
        return Identifier.toIdentifier(snakeCase, name.isQuoted())
    }
}

然后在application.yml中配置Gorm使用这个统一策略：

grails:
  gorm:
    naming_strategy: com.your.app.UnifiedSnakeCaseNamingStrategy

关键注意事项 #

• 不要依赖spring.jpa.hibernate.naming.physical-strategy配置，Grails的Gorm自动配置可能会覆盖该属性，导致设置无效。
• 集成Envers时，必须确保Hibernate的物理命名策略和Gorm完全一致，否则审计表的命名会和主表不匹配，引发查询错误。

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