jOOQ配置的forced type未生效，无法应用到PostgreSQL的tsvector类型列

出现该问题的核心原因是配置缺失或匹配规则未命中，按以下步骤排查修改即可：

1. 补全类型转换配置 #

你当前的配置只指定了目标自定义类型，没有告知jOOQ如何在JDBC原生类型和自定义类型之间做转换，必须补充converter或binding配置：

第一步：编写类型转换器 #

示例自定义转换器代码：

package example.textsearch;

import org.jooq.Converter;
import org.postgresql.util.PGobject;

public class TsVectorConverter implements Converter<Object, TsVector> {
    @Override
    public TsVector from(Object databaseValue) {
        if (databaseValue == null) return null;
        // 自行实现将PG返回的tsvector对象转为自定义TsVector类的逻辑
        return new TsVector(databaseValue.toString());
    }

    @Override
    public Object to(TsVector userValue) {
        if (userValue == null) return null;
        try {
            PGobject pgObj = new PGobject();
            pgObj.setType("tsvector");
            pgObj.setValue(userValue.toString());
            return pgObj;
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    @Override
    public Class<Object> fromType() {
        return Object.class;
    }

    @Override
    public Class<TsVector> toType() {
        return TsVector.class;
    }
}

第二步：更新forcedType配置 #

<forcedTypes>
    <forcedType>
        <userType>example.textsearch.TsVector</userType>
        <!-- 补充转换器配置 -->
        <converter>example.textsearch.TsVectorConverter</converter>
        <includeTypes>.*tsvector.*</includeTypes>
        <!-- 兜底配置：如果类型匹配一直不生效，可以直接指定列名匹配，确保命中目标列 -->
        <!-- <includeExpression>.*\.ts_message_text</includeExpression> -->
    </forcedType>
</forcedTypes>

2. 检查匹配规则问题 #

• 确认正则表达式没有多余空格，jOOQ默认开启Pattern.COMMENTS，正则中的空格会被忽略导致匹配失败
• 可以将includeTypes修改为.*(tsvector|pg_catalog\.tsvector).*，显式兼容带schema的类型名

3. 检查配置层级 #

确认forcedTypes标签是放在代码生成配置的<database>子节点下，不要放错配置层级。

4. 版本兼容问题 #

部分低版本jOOQ对PostgreSQL内置UDT的类型匹配存在bug，可尝试升级到对应大版本的最新小版本，或显式添加<udtSchema>pg_catalog</udtSchema>配置。

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