使用Eclipse Oxygen 3（2018年3月）时，org.hibernate.query.QueryParameter依赖无法解析怎么办？

我之前也碰到过这个问题，结合你用的Eclipse Oxygen 3（2018年3月版）和Maven环境，给你几个靠谱的排查解决方向：

1. 检查并升级Hibernate依赖版本 #

org.hibernate.query.QueryParameter是Hibernate ORM 5.2及以上版本才引入的类，如果你的pom.xml里Hibernate核心依赖版本低于5.2，肯定找不到这个类。

打开项目的pom.xml，找到Hibernate相关依赖块，比如如果是这样的旧版本：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.1.17.Final</version> <!-- 版本过低，无QueryParameter类 -->
</dependency>

把版本升级到5.2及以上的稳定版，比如：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.2.18.Final</version>
</dependency>

2. 刷新Maven依赖，同步到Eclipse #

有时候依赖配置已经正确，但Eclipse没同步本地仓库的最新内容。可以这么操作：

• 右键你的项目 → Maven → Update Project...
• 在弹出窗口勾选你的项目，同时勾选"Force Update of Snapshots/Releases"，点击OK等待更新完成
• 之后再检查类是否能正常解析

3. 检查依赖范围是否正确 #

如果你的Hibernate依赖设置了<scope>test</scope>这类限制范围的标签，但代码是在src/main/java下使用QueryParameter，编译时就会找不到类。确保依赖范围是默认的compile（可以不写该标签，默认即为compile）：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.2.18.Final</version>
    <!-- 不要加<scope>test</scope>，除非只在测试代码中使用 -->
</dependency>

4. 清理并重建项目 #

如果上面的步骤都没效果，可以试试清理项目缓存并重新构建：

• 右键项目 → Project → Clean...，选择你的项目执行清理
• 在Eclipse的Terminal中运行mvn clean install命令，重新构建整个项目

内容的提问来源于stack exchange，提问作者Ana Prodanović