如何在MariaDB中使用hibernate-types的JsonStringType？

我之前也碰到过类似的MariaDB和Hibernate JSON类型兼容问题，核心矛盾就是MariaDB的JSON并非原生类型，只是带CHECK (JSON_VALID(column))约束的LONGTEXT别名，而Hibernate的JsonStringType对类型的预期和MariaDB驱动的识别不匹配。下面给你两种可行的解决思路：

方法一：自定义MariaDB方言（推荐） #

通过扩展Hibernate的MariaDB方言，让它正确处理JSON类型的映射逻辑，同时满足hbm2ddl=create生成约束、hbm2ddl=validate通过校验的需求。

1. 创建自定义方言类：

import org.hibernate.dialect.MariaDBDialect
import java.sql.Types

class CustomMariaDBDialect : MariaDBDialect() {
    init {
        // 注册JSON类型映射：将Hibernate的Types#OTHER映射为MariaDB的JSON类型
        registerColumnType(Types.OTHER, "JSON")
    }
}

2. 在项目配置中指定自定义方言（以Spring Boot为例）：
   在application.properties里添加：

spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomMariaDBDialect

3. 保持实体类的原有配置不变：

@TypeDefs(TypeDef(name = "JSON", typeClass = JsonStringType::class))
class SomeEntity {
    // ...
    @Type(type = "JSON")
    @Column(nullable = false, columnDefinition = "JSON")
    var data: SomeData = SomeData()
}

这样做的优势：

• 执行hbm2ddl=create时，会自动创建带CHECK (JSON_VALID(data))约束的JSON列（本质是LONGTEXT）
• 执行hbm2ddl=validate时，Hibernate通过自定义方言识别到列类型为Types#OTHER，和JsonStringType的预期完全匹配，不会抛出类型不匹配的错误

方法二：结合@Column与@Check注解 #

如果不想自定义方言，可以用LONGTEXT作为列定义，同时手动添加@Check注解来生成JSON有效性约束：

import org.hibernate.annotations.Check

@TypeDefs(TypeDef(name = "JSON", typeClass = JsonStringType::class))
class SomeEntity {
    // ...
    @Type(type = "JSON")
    @Column(nullable = false, columnDefinition = "LONGTEXT")
    @Check(constraints = "JSON_VALID(data)")
    var data: SomeData = SomeData()
}

这种方式的注意点：

• hbm2ddl=create时会生成LONGTEXT列并带上CHECK约束，完全符合MariaDB的JSON类型规范
• hbm2ddl=validate时，Hibernate识别列类型为Types#LONGVARCHAR，而JsonStringType本身支持字符串类型的JSON存储，所以校验可以顺利通过

不过要提醒一句：@Check是Hibernate专属注解，如果后续切换到其他JPA实现可能会失效，另外部分旧版本Hibernate对@Check的支持可能需要额外配置。

补充小提示 #

如果你使用的hibernate-types版本在2.10以上，可以试试替换JsonStringType为MariaDbJsonType——虽然官方没明确标注支持MariaDB，但社区反馈这个类型适配得不错，替换后可能不用额外配置就能解决问题：

@TypeDefs(TypeDef(name = "JSON", typeClass = MariaDbJsonType::class))

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