Hikari连接PostgreSQL时LibPQFactory SSL工厂实例化报错解决方案

JDBC连接参数中配置的sslfactory类名存在拼写错误：配置值为org.postgresql.ssl.jdbc4.LibPQFactor，类名末尾缺失字符y，JVM无法加载该不存在的类，直接抛出实例化失败异常，导致Hikari连接池初始化中断。

• 修正类名拼写错误，将JDBC URL中sslfactory参数值改为正确的全限定类名org.postgresql.ssl.jdbc4.LibPQFactory，修正后的SSL参数片段如下：

"?sslmode=verify-ca&sslrootcert=/opt/datorama/cert/global-bundle.pem&sslfactory=org.postgresql.ssl.jdbc4.LibPQFactory";

注：原参数中ssl=true属于冗余配置，sslmode=verify-ca已默认开启SSL连接，可直接删除该冗余参数避免潜在的参数冲突。

• 校验PostgreSQL JDBC驱动版本兼容性：若修正类名后仍报类不存在错误，检查当前使用的驱动版本：
  • 驱动版本为42.2.x及以上：保留上述jdbc4子包下的LibPQFactory配置即可
  • 驱动版本低于42.2.x：将sslfactory参数值改为org.postgresql.ssl.LibPQFactory，旧版本驱动未在jdbc4子包下提供该实现类
• 校验文件权限：确认运行应用的进程用户对证书路径/opt/datorama/cert/global-bundle.pem拥有可读权限，避免类实例化后读取证书失败触发后续报错。

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