Spring Boot中Oracle数据库的HikariCP最佳实践

💡 原文中文,约11600字,阅读约需28分钟。
📝

内容提要

本文介绍了使用Spring Boot配置HikariCP与Oracle数据库的最佳实践,包括配置Oracle JDBC驱动程序和HikariCP。通过配置高可用性功能,可以在计划内和计划外停机期间提供连续服务。文章提供了详细的配置示例和步骤。

🔎

延伸解读

HikariCP 与 Oracle 高可用性的分工

文章明确指出,HikariCP 本身无法处理 Oracle 的 FAN 事件,因此计划内维护和计划外故障的应对都依赖 Oracle JDBC 驱动程序。驱动程序负责耗尽连接、清理无主连接并重发请求,而 HikariCP 仅作为连接池管理连接。这意味着在 Oracle RAC 环境中,高可用性配置的重点是正确设置 JDBC 驱动和连接字符串,而非调整 HikariCP 本身。

连接验证设置对性能的权衡

为了在计划维护期间确保连接有效,文章建议将 com.zaxxer.hikari.aliveBypassWindowMs 设为 -1,强制在签出时验证连接。但这样做可能对性能有轻微影响,因此 Oracle 推荐同时设置 oracle.jdbc.defaultConnectionValidation=LOCAL 进行轻量级验证。需要注意的是,该 HikariCP 属性是 JVM 系统属性,会影响同一 JVM 中所有 HikariCP 连接池,设置前应评估全局影响。

配置数据源属性的常见陷阱

文章通过示例指出,在 application.properties 中多次使用 spring.datasource.hikari.data-source-properties 会导致只有最后一个属性生效。正确做法是使用点号分隔的完整键名,如 spring.datasource.hikari.data-source-properties.oracle.jdbc.implicitStatementCacheSize。此外,若同时设置 driverClassName 和 dataSourceClassName,会抛出 I

不同高可用级别的配置选择

文章将高可用性分为三个级别:基本级别利用 RAC 和 FAN 实现计划外故障通知与连接重试;第二级增加连接验证以支持计划维护;第三级通过 TAC 和重放数据源实现计划外停机时的透明恢复。读者应根据应用是否具备重试逻辑、能否容忍短暂中断来选择级别,而非盲目采用最高配置。文章中的测试基于 Oracle 19c 和 JDBC 19.21.0.0,其他版本需验证兼容性。

❓

Q&A

Spring Boot 从哪个版本开始默认使用 HikariCP 作为连接池?

Spring Boot 从第 2 版开始将 HikariCP 作为默认连接池。

在 Spring Boot 中配置 HikariCP 连接 Oracle 数据库有哪几种方式?

可以通过 application.properties 文件、application.yaml 文件、使用 @Configuration 注解的配置类(通过 @Bean 定义 DataSource),以及使用 Kubernetes secret 来配置。

使用 HikariCP 连接 Oracle 数据库时,必须设置哪些最小属性?

最小属性集包括:JDBC URL、用户名、密码、驱动类名(oracle.jdbc.OracleDriver),以及可选的 HikariCP 设置如 maximum-pool-size。

如何为 HikariCP 设置多个 Oracle 数据源属性(例如 implicitStatementCacheSize 和 defaultConnectionValidation)?

需要使用带有点分隔的完整属性名,例如:spring.datasource.hikari.data-source-properties.oracle.jdbc.implicitStatementCacheSize=10 和 spring.datasource.hikari.data-source-properties.oracle.jdbc.defaultConnectionValidation=LOCAL。直接使用 spring.datasource.hikari.data-source-properties 多次赋值会导致只有最后一个生效。

在 Oracle RAC 环境下,如何配置 HikariCP 以支持计划内维护(如节点关闭)?

需要:1) 创建支持 FAN 的数据库服务;2) 配置包含 LOAD_BALANCE 和 RETRY 参数的 JDBC 连接字符串;3) 在 pom.xml 中添加 ons 和 simplefan 依赖以启用 FAN;4) 设置连接验证属性(如将 com.zaxxer.hikari.aliveBypassWindowMs 设为 -1)以确保连接在签出时被验证,从而允许 JDBC 驱动耗尽连接。

如何配置 HikariCP 以应对 Oracle 数据库的计划外停机(如实例故障)?

需要:1) 在数据库服务定义中启用透明应用程序连续性(TAC),设置 -failovertype AUTO、-failover_restore AUTO 和 -replay_init_time 600;2) 在 DataSourceConfig 中设置 dataSourceClassName 为 oracle.jdbc.replay.OracleDataSourceImpl;3) 确保 FAN 已启用,以便 JDBC 驱动清理无主连接并重放请求。

🏷️

标签

➡️

继续阅读