JPA配置bpchar字段运行H2单元测试报未知类型异常如何解决

问题场景 #

实体类字段JPA配置如下：

@Column(name = "name", columnDefinition = "bpchar(1)")
private String name;

生产环境使用PostgreSQL数据库，原生支持bpchar定长字符类型；引入H2数据库执行单元测试时抛出类型不存在异常：

org.h2.jdbc.JdbcSQLNonTransientException: Type de données inconnu: "bpchar"
Unknown data type: "bpchar"; SQL statement:

可落地兼容方案 #

• 优先方案：替换硬编码方言类型，使用JPA标准字段配置
  bpchar本质就是定长字符串类型，完全没必要在columnDefinition里硬编码绑定PostgreSQL专属类型，直接用JPA@Column注解的标准属性定义长度约束即可：

  @Column(name = "name", length = 1, nullable = false)
  private String name;
  

  这种写法不绑定任何数据库方言，Hibernate会根据当前连接的数据库自动适配对应字段类型：PostgreSQL环境下会生成符合定长要求的字符类型，H2环境下会自动映射为原生支持的char(1)，从根源上避免方言不兼容问题。
• 方案二：H2开启PG兼容模式+自定义类型别名
  如果因为历史原因必须保留columnDefinition = "bpchar(1)"的配置，可以通过H2本身的兼容配置解决：
  1. 修改测试环境H2连接地址，开启PostgreSQL兼容模式：
     jdbc:h2:mem:unittest;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1
  2. 在测试资源目录添加H2启动初始化SQL，创建bpchar类型别名映射到H2原生的定长字符类型：

     CREATE DOMAIN bpchar AS CHAR(1);
     

  注意：如果业务中bpchar字段长度不固定，需要对应调整映射的char长度，或者创建通用的映射规则。
• 方案三：自定义H2方言做类型映射
  单独为测试环境配置自定义Hibernate H2方言，在方言注册逻辑中把bpchar映射为H2支持的字符类型：
  1. 测试路径下新增自定义方言类：

     public class H2CompatibleDialect extends H2Dialect {
         public H2CompatibleDialect() {
             super();
             registerColumnType(Types.VARCHAR, "bpchar");
         }
     }
     

  2. 测试环境的JPA配置中指定hibernate.dialect为上述自定义类的全限定名即可。

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