升级Eclipse及最新JBoss Tools Hibernate后HQL编辑器异常问题排查

• 适配环境参数：Eclipse IDE 4.19.0.20210311-1200（JEE包）、本机JDK版本jdk-11.0.10
• 故障触发节点：完成Eclipse版本升级、安装最新版JBoss Tools Hibernate组件后，HQL编辑器停止正常工作，但日常开发的Web应用业务代码可正常编译、运行
• 异常抛出链路：在HQL编辑器内触发查询操作时，按层级抛出多层异常：
  • 顶层异常：javax.persistence.PersistenceException
  • 中间层异常：org.hibernate.exception.SQLGrammarException（提示无法提取ResultSet）
  • 底层数据库返回异常：java.sql.SQLSyntaxErrorException，报错内容为Unknown column 'product0_.product_category' in 'field list'
• 故障关联插件：org.hibernate.eclipse.console

• 对齐Hibernate Console的实体映射加载范围
  业务代码正常运行说明项目本身的JPA实体与数据库表的映射关系完全正确，异常来源是Eclipse内置的Hibernate Console插件加载了错误的映射元数据，自动生成了包含不存在字段product_category的查询语句。可打开Eclipse的「Hibernate Configurations」视图，选中当前项目对应的控制台配置，核对配置关联的实体类扫描范围、ORM配置文件的指向路径，清除残留的旧实体映射配置条目，确保插件加载的映射定义和项目实际运行使用的映射完全一致。
• 清理插件本地缓存
  版本升级后，旧的Hibernate工具缓存和新版本插件的解析逻辑不兼容，会生成错误的列映射规则。操作时关闭Eclipse，定位当前工作区下.metadata/.plugins/org.hibernate.eclipse.console目录，删除目录内所有临时缓存文件，重启Eclipse后重新加载项目的Hibernate配置即可。
• 匹配插件与Eclipse的兼容版本
  若前两步操作后异常仍存在，说明当前安装的最新版JBoss Tools Hibernate组件与Eclipse 4.19版本存在版本适配问题——最新版组件是为更高版本Eclipse设计的，内置的实体解析逻辑无法兼容当前JDK11环境下的项目结构。此时可通过Eclipse的「Install New Software」功能，将JBoss Tools的Hibernate组件降级到与Eclipse 4.19（2021-03发布线）适配的对应版本。
• 调整Hibernate Console的类路径加载顺序
  部分场景下插件执行HQL查询时，会优先加载自带的Hibernate核心库，而非项目本身引入的Hibernate依赖版本，导致实体映射解析规则不匹配。可在Hibernate Console配置的「Classpath」标签页，将项目自身的依赖包（包含JPA实体定义、项目引入的Hibernate核心库）移动到类路径最顶部，让控制台优先使用项目的类定义完成映射解析，而非依赖插件自带的库实现。

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