支持Oracle与MSSQL时的Schema验证及Unicode存储适配问题

问题背景 #

• MSSQL的varchar不支持Unicode，必须用nvarchar配合Hibernate的@Nationalized注解才能正常存储Unicode字符
• Oracle的varchar2通过配置（如设置NLS_CHARACTERSET=AL32UTF8）即可支持Unicode，但使用@Nationalized注解时，Hibernate会期望映射到nvarchar2类型，而现有Schema是varchar2，导致报错：

  found [varchar2 (Types#VARCHAR)], but expecting [nvarchar2(255) (Types#NVARCHAR)]

解决方案 #

1. 自定义Oracle方言，修改@Nationalized的映射规则 #

Hibernate默认Oracle方言会把@Nationalized注解字段映射为nvarchar2，可以自定义方言覆盖该行为，让其映射到varchar2：

public class CustomOracleDialect extends Oracle12cDialect {
    public CustomOracleDialect() {
        super();
        // 将Nationalized类型映射到varchar2
        registerColumnType(Types.NVARCHAR, "varchar2($l)");
        registerColumnType(Types.NCHAR, "char($l)");
        registerColumnType(Types.NCLOB, "clob");
    }
}

然后在Hibernate配置中指定方言：

# Oracle环境使用自定义方言
hibernate.dialect=com.yourpackage.CustomOracleDialect
# MSSQL环境使用默认方言
# hibernate.dialect=org.hibernate.dialect.SQLServer2012Dialect

2. 条件注解动态启用@Nationalized #

利用条件注解，仅在MSSQL环境下添加@Nationalized，Oracle环境下不启用：

@Entity
public class YourEntity {
    // 仅MSSQL环境应用@Nationalized
    @Nationalized
    @Conditional(MsSqlCondition.class)
    @Column(length = 255)
    private String unicodeField;

    // 其他字段...
}

实现判断数据库类型的条件类：

public class MsSqlCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String dialect = context.getEnvironment().getProperty("hibernate.dialect");
        return dialect != null && dialect.contains("SQLServer");
    }
}

3. 统一使用@Type注解指定字符类型 #

放弃@Nationalized，直接用@Type适配不同数据库的字符类型：

@Entity
public class YourEntity {
    @Column(length = 255)
    @Type(type = "org.hibernate.type.StringNVarcharType")
    private String unicodeField;
}

也可通过配置文件灵活切换：

# Oracle环境
hibernate.type.string_nvarchar_type=org.hibernate.type.StringType
# MSSQL环境
hibernate.type.string_nvarchar_type=org.hibernate.type.StringNVarcharType

4. 数据库配置+Hibernate全局参数配合 #

• Oracle：确保数据库NLS_CHARACTERSET设置为AL32UTF8（支持Unicode），无需修改Schema
• MSSQL：字段使用nvarchar类型
• 添加Hibernate全局参数自动适配：

# 启用国际化字符数据支持，Hibernate根据方言自动处理类型映射
hibernate.use_nationalized_character_data=true

该参数在MSSQL下自动映射到nvarchar，Oracle环境需配合方案1的自定义方言使用，避免映射到nvarchar2。

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