Hibernate 6.2.2与MySQL 5.7中@Nationalized注解字段映射异常

问题背景 #

我们将应用从Spring Boot 2.3.9升级至Spring Boot 3.1.0，同步把Hibernate从5.4.28.Final升级到6.2.2.Final，应用部署在AWS RDS的MySQL 5.7.mysql_aurora.2.11.2环境，数据库默认编码为latin1。升级后发现所有标注@Nationalized的String字段出现映射异常：

升级前（Hibernate 5.4.28.Final） #

生成的JPA DDL列定义：

first_name nvarchar(255)

数据库实际列信息：

`first_name` varchar(255) CHARACTER SET utf8 DEFAULT NULL,

升级后（Hibernate 6.2.2.Final） #

生成的JPA DDL列定义：

first_name varchar(255)

数据库实际列信息：

`first_name` varchar(255) DEFAULT NULL,

问题根源追踪 #

通过查看org.hibernate.dialect.MySQLDialect类第330-341行代码发现：

final CapacityDependentDdlType.Builder nvarcharBuilder = CapacityDependentDdlType.builder(
                        NVARCHAR,
                        columnType( NCLOB ),
                        "char",
                        this
                )
                .withTypeCapacity( getMaxVarcharLength(), "varchar($l)" )
                .withTypeCapacity( maxMediumLobLen, "mediumtext" );
        if ( getMaxVarcharLength() < maxLobLen ) {
            nvarcharBuilder.withTypeCapacity( maxLobLen, "text" );
        }
        ddlTypeRegistry.addDescriptor( nvarcharBuilder.build() );

字段已正确映射为NVARCHAR类型（type=-9），但DDL生成时无法选择nvarchar关键字——因为配置中仅提供了varchar($l)、mediumtext、text三种选项，没有包含nvarchar。

变更目的解析 #

Hibernate 6对MySQL方言的NVARCHAR映射逻辑做了调整，核心原因如下：

1. 对齐MySQL实际行为：MySQL中的nvarchar本质是绑定了国家字符集的varchar，从MySQL 5.5版本开始，通过CHARACTER SET utf8或utf8mb4定义的varchar，完全可以实现nvarchar的功能，二者在功能上没有本质区别。
2. 简化方言逻辑：旧版Hibernate强制生成nvarchar关键字，但MySQL对该关键字的支持更多是为了兼容其他数据库语法，并非必需。Hibernate 6移除了这一冗余逻辑，转而依赖更标准的字符集配置方式。
3. 引导规范配置：Hibernate团队希望开发者通过数据库默认字符集或列级字符集指定（如utf8mb4）来处理国际化字符，而非依赖nvarchar这种MySQL特定语法，这样能提升代码的跨数据库兼容性。

当MySQL方言的org.hibernate.dialect.NationalizationSupport设为EXPLICIT时，Hibernate会认为开发者会通过显式的字符集配置来处理国际化字段，因此不再自动生成nvarchar关键字，而是生成标准的varchar，由数据库的字符集规则决定最终的列属性。

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