HikariCP支持绝对路径和类路径相对路径两种配置文件加载方式，需符合Java Properties格式；常用配置包括jdbcUrl、username、password等，代码中可通过构造传参、loadProperties或JVM系统属性三种方式加载。
支持的配置文件路径方式
HikariCP 支持两种加载外部配置文件的路径形式：
- 绝对路径：如 /etc/hikari/hikari.properties，直接按文件系统路径读取
- 类路径相对路径：如 hikari.properties 或 config/hikari.conf，会从 classpath（如 src/main/resources）中查找
配置文件内容格式要求
必须是标准 Java Properties 格式，键名需符合 HikariConfig 属性命名规范。常用必需项包括：
-
jdbcUrl：完整 JDBC 连接串，例如
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC - username 和 password：数据库登录凭证
- 可选但推荐：
poolName、maximumPoolSize、minimumIdle、connectionTimeout
注意：若使用 dataSourceClassName（如 PostgreSQL 的 org.postgresql.ds.PGSimpleDataSource），则 jdbcUrl 不再必需，但需配套设置 dataSource.user、dataSource.password 等前缀属性。
代码中加载配置文件的三种写法
方式一：构造时传入路径字符串（推荐）
立即学习“Java免费学习笔记（深入）”；
HikariConfig config = new HikariConfig("/path/to/hikari.properties");<br>HikariDataSource ds = new HikariDataSource(config);
方式二：先创建空配置，再显式调用 loadProperties
HikariConfig config = new HikariConfig();<br>config.loadProperties(new FileInputStream("/path/to/hikari.properties"));<br>HikariDataSource ds = new HikariDataSource(config);
方式三：通过 JVM 系统属性自动触发加载
java -Dhikaricp.configurationFile=/path/to/hikari.properties MyApp
此时只需 new HikariDataSource()，HikariConfig 构造器会自动识别并加载。
常见问题与验证要点
加载失败时通常抛出 IllegalArgumentException("Cannot find property file") 或 RuntimeException("Failed to read property file")，排查重点：
- 路径是否拼写正确，特别是 Windows 下反斜杠需转义或改用正斜杠
- 文件是否存在且应用有读取权限（尤其在容器或生产环境）
- 配置项名称是否大小写准确（如
maximumPoolSize≠maxPoolSize） - 启动日志中应出现类似
HikariPool-1 - Starting...和HikariPool-1 - Start completed.的提示，表明初始化成功
