如何让Hibernate的hbm2java生成代码时使用自定义UserType？

针对你在Spring Boot项目中用hbm2java生成实体类时，需要映射PostgreSQL ltree类型到自定义UserType的问题，下面提供两种可行的实现方案，同时解决你遇到的类型解析错误问题：

一、使用reveng.xml配置类型映射 #

reveng.xml是Hibernate反向工程的配置文件，依然可以在新版本的hibernate-tools中使用。你遇到的Could not resolve named type错误，本质是插件没找到你的LTreeType类，解决步骤如下：

1. 编写reveng.xml配置文件
   在src/main/resources下创建该文件，指定ltree类型到自定义UserType的映射：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-reverse-engineering PUBLIC
        "-//Hibernate/Hibernate Reverse Engineering DTD 3.0//EN"
        "https://hibernate.org/dtd/hibernate-reverse-engineering-3.0.dtd">
<hibernate-reverse-engineering>
    <type-mapping>
        <!-- sql-type-name必须和数据库中的字段类型完全一致（即ltree） -->
        <sql-type sql-type-name="ltree" hibernate-type="com.yourpackage.LTreeType"/>
    </type-mapping>
</hibernate-reverse-engineering>

2. 配置Maven插件，添加类路径
   修改pom.xml中的hibernate-tools插件配置，将源码目录加入插件的类路径，确保插件能找到未编译的LTreeType.java：

<plugin>
    <groupId>org.hibernate.tool</groupId>
    <artifactId>hibernate-tools-maven</artifactId>
    <version>6.2.1.Final</version>
    <executions>
        <execution>
            <id>entity-generation</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>hbm2java</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <jdbcDriver>org.postgresql.Driver</jdbcDriver>
        <jdbcUrl>jdbc:postgresql://localhost:5432/你的数据库名</jdbcUrl>
        <jdbcUser>你的数据库用户名</jdbcUser>
        <jdbcPassword>你的数据库密码</jdbcPassword>
        <!-- 指定reveng.xml路径 -->
        <revengFile>src/main/resources/reveng.xml</revengFile>
        <!-- 把源码目录加入插件类路径，解决类型找不到的问题 -->
        <additionalClasspathElements>
            <additionalClasspathElement>${project.basedir}/src/main/java</additionalClasspathElement>
        </additionalClasspathElements>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.postgresql</groupId>
            <artifactId>postgresql</artifactId>
            <version>你的PostgreSQL驱动版本</version>
        </dependency>
    </dependencies>
</plugin>

二、自定义ReverseEngineeringStrategy子类 #

如果reveng.xml的方式不顺畅，也可以通过继承默认策略类来实现类型映射：

1. 编写自定义策略类
   继承DefaultReverseEngineeringStrategy，重写字段类型映射方法：

import org.hibernate.cfg.reveng.DefaultReverseEngineeringStrategy;
import org.hibernate.cfg.reveng.TableIdentifier;

public class CustomReverseEngineeringStrategy extends DefaultReverseEngineeringStrategy {

    @Override
    public String columnToHibernateTypeName(TableIdentifier table, String columnName, int sqlType, String sqlTypeName, int length, int precision, int scale, boolean nullable, boolean generatedIdentifier) {
        // 匹配数据库中的ltree类型字段
        if ("ltree".equalsIgnoreCase(sqlTypeName)) {
            return "com.yourpackage.LTreeType";
        }
        // 其他字段使用默认映射逻辑
        return super.columnToHibernateTypeName(table, columnName, sqlType, sqlTypeName, length, precision, scale, nullable, generatedIdentifier);
    }
}

2. 配置Maven插件使用该策略
   同样需要把源码目录加入插件类路径，修改pom.xml配置：

<plugin>
    <groupId>org.hibernate.tool</groupId>
    <artifactId>hibernate-tools-maven</artifactId>
    <version>6.2.1.Final</version>
    <executions>
        <execution>
            <id>entity-generation</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>hbm2java</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <jdbcDriver>org.postgresql.Driver</jdbcDriver>
        <jdbcUrl>jdbc:postgresql://localhost:5432/你的数据库名</jdbcUrl>
        <jdbcUser>你的数据库用户名</jdbcUser>
        <jdbcPassword>你的数据库密码</jdbcPassword>
        <!-- 指定自定义策略类的全类名 -->
        <reverseEngineeringStrategy>com.yourpackage.CustomReverseEngineeringStrategy</reverseEngineeringStrategy>
        <!-- 添加源码目录到类路径 -->
        <additionalClasspathElements>
            <additionalClasspathElement>${project.basedir}/src/main/java</additionalClasspathElement>
        </additionalClasspathElements>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.postgresql</groupId>
            <artifactId>postgresql</artifactId>
            <version>你的PostgreSQL驱动版本</version>
        </dependency>
    </dependencies>
</plugin>

额外提醒 #

• 确保你的LTreeType类完全实现了Hibernate UserType接口的所有方法（比如nullSafeGet、nullSafeSet），否则生成实体类后运行时会出现类型转换错误。
• 正如你所说，hibernate-tools的文档确实非常不完善，版本兼容性问题也较多，如果项目有选择空间，建议考虑替代方案：比如手动使用JPA的@Converter注解处理类型映射，或者使用其他成熟的代码生成工具（如MyBatis Generator）。

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