Spring Boot 2迁移至3运行异常求助：JPA查询失败及线程内存泄漏

一、Oracle JDBC线程内存泄漏警告（BlockReleaser/InterruptTimer） #

解决步骤：

• 升级Oracle JDBC驱动：Spring Boot 3.x适配Java 17，需使用ojdbc11驱动，在pom.xml中更新依赖：

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc11</artifactId>
    <version>21.13.0.0</version> <!-- 选择兼容Oracle 19的稳定版本 -->
    <scope>runtime</scope>
</dependency>

旧版ojdbc8在Java 17环境下存在线程回收机制的兼容性问题，升级后可解决多数线程泄漏警告。

• 配置连接池销毁策略：若使用HikariCP（Spring Boot默认），添加以下配置确保连接池关闭时线程正常终止：

spring.datasource.hikari.shutdown-timeout=3000
spring.datasource.hikari.max-lifetime=1800000

自定义数据源需添加@PreDestroy方法手动关闭资源：

@PreDestroy
public void closeDataSource() throws SQLException {
    if (dataSource != null) {
        dataSource.close();
    }
}

• 检查JDBC资源回收：确保所有Connection、Statement、ResultSet都通过try-with-resources块管理，避免资源泄漏：

try (Connection conn = dataSource.getConnection();
     PreparedStatement stmt = conn.prepareStatement(sql)) {
    // 执行查询逻辑
} catch (SQLException e) {
    // 异常处理
}

二、HQL cast语法错误导致ApplicationContext启动失败 #

解决步骤：

• 修正HQL cast语法：Spring Boot 3.x基于Hibernate 6.x，HQL的cast语法与旧版Hibernate 5.x存在差异。旧版可能允许松散写法，Hibernate 6.x要求严格遵循标准语法：
  • 错误示例：cast(user.id, varchar)
  • 正确示例：cast(user.id as varchar)（对应Oracle数据库类型）或cast(user.id as String)（对应Java类型）
• 手动指定@Query语句：若Spring Data JPA方法名自动生成的HQL存在语法问题，直接用@Query注解编写正确查询：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u WHERE u.company = :company AND u.status = :status ORDER BY u.id")
    Page<User> findPaginatedByCompanyAndStatus(@Param("company") String company, 
                                              @Param("status") Integer status, 
                                              Pageable pageable);
}

如果查询中需要cast转换，比如对日期字段转换：

@Query("SELECT u FROM User u WHERE cast(u.createTime as date) = :targetDate")
List<User> findByCreateDate(@Param("targetDate") LocalDate targetDate);

• 适配Hibernate 6.x语法规范：避免使用Hibernate 5.x的专属语法，比如旧版的function('cast', xxx, 'type')需替换为标准cast表达式，确保所有HQL符合JPA 3.0规范。

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