JOOQ基于Liquibase代码生成时如何将H2/PostgreSQL的JSONB类型映射为TEXT
解决H2 PostgreSQL兼容模式下JOOQ代码生成识别JSONB类型报错的方案
报错根因
你当前配置的INIT=create domain if not exists jsonb as text只会在JDBC连接初始化时,在H2的系统元数据里建立jsonb域与TEXT类型的映射,但Liquibase在解析变更文件、校验列类型的阶段,是优先做本地类型字符串比对的,根本不会触发H2系统表的域定义查询逻辑,因此只要变更文件里出现JSONB类型定义,就会直接抛出未知类型错误,后续的JOOQ代码生成环节自然也会受影响。
可落地的解决配置
- 方案1:在JOOQ生成器中配置强制类型映射
这是改动最小的通用方案,在JOOQ的代码生成配置中添加强制类型匹配规则,让生成器碰到JSONB类型的列时,直接按TEXT/VARCHAR规则处理,配置示例如下:
配置生效后,JOOQ读数据库元数据时,只要识别到列的SQL类型为JSONB,就会映射为Java的String类型,跳过未知类型校验逻辑。<!-- JOOQ生成器<database>节点内添加 --> <forcedType> <name>VARCHAR</name> <!-- 正则匹配所有JSONB类型的列,不区分大小写 --> <types>JSONB</types> </forcedType> - 方案2:给Liquibase注册自定义类型别名
针对Liquibase抛出的未知类型报错,可以在Spring环境下通过配置参数把JSONB注册为Liquibase可识别的自定义类型,直接映射为底层CLOB/TEXT,配置示例:
配置完成后,Liquibase解析变更文件时碰到JSONB类型,会自动套用映射后的CLOB定义,不会再触发未知类型异常。spring: liquibase: parameters: # 将JSONB注册为Liquibase内置可识别类型,映射为大文本存储 jsonb.type: CLOB - 方案3:变更文件按数据库类型做分支适配
这种方案不需要调整任何全局配置,直接在Liquibase变更集里针对H2和PostgreSQL做类型分支判断,H2环境下直接建TEXT类型的列,PostgreSQL环境下保留原生JSONB类型,示例:
这种方案下H2实例里的列是原生TEXT类型,不管是Liquibase还是JOOQ读元数据时都能正常识别,完全不会触发类型报错,且和生产环境的行为保持一致。<changeSet id="add-config-column" author="dev"> <!-- H2环境下用TEXT适配JSONB的存储需求 --> <sql dbms="h2"> ALTER TABLE business_table ADD COLUMN config TEXT; </sql> <!-- 生产PostgreSQL环境保留原生JSONB类型 --> <sql dbms="postgresql"> ALTER TABLE business_table ADD COLUMN config JSONB; </sql> </changeSet>
额外提示:如果你使用的是3.17及以上版本的JOOQ,已经内置了PostgreSQL方言下JSONB类型的映射规则,只要在代码生成环节把数据库方言设置为
POSTGRES,即使H2底层把JSONB存为TEXT,也会自动匹配对应类型映射,不需要额外添加强制类型规则。
内容的提问来源于stack exchange,提问作者Ken Yee
相关产品推荐
相关产品推荐

