Hibernate 6.3中JPA Metamodel生成失败求助

问题描述 #

在Hibernate 6.3项目中配置JPA Metamodel生成，添加了如下maven-compiler-plugin配置：

<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.10.1</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
        <release>20</release>
        <annotationProcessorPaths>
            <annotationProcessorPath>
                <groupId>org.hibernate.orm</groupId>
                <artifactId>hibernate-jpamodelgen</artifactId>
                <version>6.3.0.Final</version>
            </annotationProcessorPath>
        </annotationProcessorPaths>
    </configuration>
</plugin>

执行mvn install时触发错误：

Error generating JPA metamodel: Range [0, 3) out of bounds for length 1
启用调试模式未获取有效排查信息。

解决方案 #

1. 升级maven-compiler-plugin版本 #

maven-compiler-plugin 3.10.1版本较旧，与Java 20及Hibernate 6.3的兼容性可能存在问题，建议升级到最新稳定版（如3.12.1）：

<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.12.1</version>
    <configuration>
        <source>${java.version}</source>
        <target>${java.version}</target>
        <release>20</release>
        <annotationProcessorPaths>
            <annotationProcessorPath>
                <groupId>org.hibernate.orm</groupId>
                <artifactId>hibernate-jpamodelgen</artifactId>
                <version>6.3.0.Final</version>
            </annotationProcessorPath>
        </annotationProcessorPaths>
    </configuration>
</plugin>

2. 排查实体类的异常注解配置 #

该错误通常是JPAModelGen解析实体类时遇到字符串索引越界，重点检查：

• 实体类中@Column、@Enumerated等注解的参数是否存在异常（比如length设置为0或负数，或者字符串值长度不符合预期）
• 是否有空字符串作为注解参数（比如@Column(name = "")）
• 嵌入式类、枚举类的定义是否存在格式问题

可以通过逐步注释实体类的方式，定位到触发错误的具体实体，再针对性修复。

3. 升级Hibernate JPAModelGen版本 #

尝试使用Hibernate 6.3系列的后续版本，该错误可能是6.3.0.Final的已知bug，已在后续版本修复：

<annotationProcessorPath>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-jpamodelgen</artifactId>
    <version>6.3.2.Final</version>
</annotationProcessorPath>

4. 清理冲突的注解处理器 #

确保annotationProcessorPaths中仅包含hibernate-jpamodelgen，避免其他JPA注解处理器（如EclipseLink的处理器）引发依赖冲突。

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