如何用jOOQ将Java Instant映射到H2的TIMESTAMP WITH TIME ZONE？

核心原因 #

jOOQ的includeTypes参数是正则表达式，且默认启用Pattern.COMMENTS模式——该模式会忽略正则中的空格和注释。你配置的includeTypes = 'TIMESTAMP WITH TIME ZONE'会被jOOQ解析为无空格的正则TIMESTAMPWITHTIMEZONE，无法匹配H2实际返回的带空格的类型名称。

另外，jOOQ对不同数据库的同类型有统一内置别名，H2的TIMESTAMP WITH TIME ZONE也可通过TIMESTAMPTZ这个通用别名匹配，和PostgreSQL的配置逻辑一致。

解决方案 #

方案1：使用jOOQ通用类型别名（推荐） #

直接复用PostgreSQL的配置逻辑，将includeTypes设为TIMESTAMPTZ，jOOQ会自动匹配H2的带时区时间戳类型：

forcedTypes {
    forcedType {
        name = 'instant'
        includeExpression = '.*'
        includeTypes = 'TIMESTAMPTZ'
    }
}

方案2：修正正则表达式适配空格 #

如果要针对H2的原生类型名称匹配，需考虑Pattern.COMMENTS的影响，用\s+匹配任意空格：

forcedTypes {
    forcedType {
        name = 'instant'
        includeExpression = '.*'
        includeTypes = 'TIMESTAMP\\s+WITH\\s+TIME\\s+ZONE'
    }
}

或者直接去掉正则中的空格（因为Pattern.COMMENTS会忽略原字符串空格）：

forcedTypes {
    forcedType {
        name = 'instant'
        includeExpression = '.*'
        includeTypes = 'TIMESTAMPWITHTIMEZONE'
    }
}

验证方法 #

若不确定jOOQ实际识别的类型名称，可开启DEBUG日志查看：

• Gradle：运行代码生成任务时添加--debug参数
• Maven：添加-X参数
  从日志中找到表列的类型输出，即可明确jOOQ读取到的类型字符串，再调整正则匹配规则。

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