SpringBoot中从HikariCP迁移到Oracle UCP指南
内容提要
本文介绍了从HikariCP迁移到Oracle UCP的指南，包括迁移过程和优化Java连接池时可用的Oracle UCP属性集。
延伸解读
迁移的关键配置与依赖调整
从 HikariCP 迁移到 Oracle UCP 时，需在 Maven 中显式添加 ojdbc11 和 ucp11 依赖，或使用 Oracle 的 Spring Boot Starter。同时，应排除默认引入的 HikariCP 依赖，并通过设置 spring.datasource.type=oracle.ucp.jdbc.PoolDataSource 强制 Spring Boot 使用 UCP。这是因为 Spring Boot 的连接池选择算法会优先选择 HikariCP，只有显式指定类型才能绕过该算法。
属性映射与行为差异需留意
文章提供了 HikariCP 与 UCP 的属性映射表，但部分属性并非完全等价。例如，connectionTimeout 在 UCP 23.2 及以上版本支持毫秒，之前版本仅支持秒；keepaliveTime 在 UCP 中需通过驱动程序属性 oracle.net.keepAlive 和 oracle.net.TCP_KEEPIDLE 实现，且作用于所有连接而非仅空闲连接。迁移时应仔细核对版本和语义差异，避免配置失效。
UCP 独有的高级功能与监控
UCP 提供了 HikariCP 不具备的高级特性，如快速连接故障转移（FCF）、运行时连接负载平衡（RLB）、连接亲和性、分片支持以及多租户 PDB 角色管理等。此外，UCP 通过 OracleJDBCConnectionPoolStatistics 暴露丰富的池指标，包括借用等待时间、连接回收计数等，便于监控和调优。这些功能在 Oracle RAC 或云数据库环境中尤其有价值。
Q&A
Spring Boot 默认使用 HikariCP，如果想换成 Oracle UCP，需要改哪个配置？
需要设置 spring.datasource.type=oracle.ucp.jdbc.PoolDataSource。Spring Boot 的连接池选择算法会优先选 HikariCP，其次 Tomcat JDBC、DBCP2，最后才是 UCP；通过显式指定该属性可以绕过算法直接使用 UCP。
从 HikariCP 迁移到 Oracle UCP 需要添加哪些 Maven 依赖？
可以显式添加 ojdbc11 和 ucp11 两个依赖（版本如 23.3.0.23.09），或者使用 Oracle 提供的 Spring Boot Starter：oracle-spring-boot-starter-ucp（版本如 23.4.0）。
HikariCP 的 maximumPoolSize 和 connectionTimeout 在 UCP 里对应什么属性？
maximumPoolSize 对应 MaxPoolSize；connectionTimeout 对应 ConnectionWaitTimeout（UCP 23.2 支持毫秒，之前版本支持秒，HikariCP 最低可接受 250ms）。
Oracle UCP 相比 HikariCP 有哪些高级功能？
UCP 支持快速连接故障转移（FCF）、运行时连接负载平衡（RLB）、连接亲和性、分片、Oracle 多租户 PDB 角色、连接标签与成本、异步借用连接（CompletionStage/Flow API）等，并利用 Oracle RAC 的高可用特性。
在 Spring Boot 中配置 Oracle UCP 时，application.properties 里最少要写哪些属性？
至少需要配置 spring.datasource.url、spring.datasource.username、spring.datasource.password，以及 spring.datasource.type=oracle.ucp.jdbc.PoolDataSource。还可以按需添加 UCP 特有属性，如 connection-pool-name、initial-pool-size、min-pool-size、max-pool-size、connection-factory-class-name 等。
HikariCP 的 metrics 在 UCP 中如何对应？
例如：活动连接数对应 BorrowedConnectionsCount，等待请求数对应 PendingRequestsCount，超时请求总数对应 CumulativeFailedConnectionWaitCount，获取连接耗时对应 PeakConnectionWaitTime/AverageConnectionWaitTime，当前总连接数对应 TotalConnectionsCount，空闲连接数对应 AvailableConnectionsCount，最大连接数对应 PeakConnectionsCount。
