Hibernate 7.1.0报UnknownAnnotationAttributeException异常求助（未用check）

问题分析 #

你遇到的异常源于Hibernate 7.1.0对JPA注解的校验逻辑做了强化——严格遵循JPA规范的jakarta.persistence.Table注解本身并没有check属性，而Hibernate 6.4.4版本对这类非标准属性兼容性更强，会直接忽略。虽然你没直接使用check属性，但大概率是项目中存在间接引入的代码在操作@Table注解时添加了这个属性。

可能的触发点 #

• 依赖传递的旧工具/库：项目依赖的第三方库（比如某些ORM扩展、字节码增强插件）可能在编译或运行时动态给@Table注解添加了check属性。
• 编译产物残留：之前用Hibernate 6.4.4编译生成的字节码文件中，可能被旧版注解处理器注入了check属性，升级后未清理导致冲突。
• 框架版本不兼容：Spring Data JPA等框架的旧版本，可能通过字节码修改扩展了@Table注解的属性集合，和Hibernate 7.1.0的严格校验不兼容。

解决步骤 #

• 彻底清理并重新编译：删除项目的编译输出目录（Maven的target、Gradle的build），执行完整的构建命令，确保没有旧字节码残留：

  # Maven
  mvn clean install
  # Gradle
  gradle clean build
  

• 排查依赖树：检查项目依赖中是否包含可能修改JPA注解的库，用依赖分析工具找出可疑项并排除：

  # Maven查看依赖树
  mvn dependency:tree
  # Gradle查看依赖树
  gradle dependencies
  

  找到相关依赖后，在构建文件中排除对应的模块。
• 升级第三方框架：如果是Spring Data JPA等框架导致的问题，升级到支持Hibernate 7.1.0的最新版本，确保框架的注解处理逻辑符合规范。
• 检查自定义代码：如果项目有自定义注解处理器或字节码增强逻辑，确认是否误给@Table添加了check属性，移除相关代码即可。

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