升级Spring、Hibernate等组件后QA环境登录出现JDBC异常如何解决

根因定位 #

报错的核心原因是PostgreSQL JDBC驱动版本与数据库版本、Hibernate版本不兼容：

• 你使用的42.0.0版本PG JDBC驱动发布于2017年，远早于PostgreSQL 12.2的发布时间，对PG12的新特性、JDBC4.2+ API的支持都不完善
• Hibernate 5.4.x版本默认会调用JDBC 4.2及以上版本的接口方法，旧驱动未实现这些方法，就会抛出This method is not yet implemented、SQLSTATE 0A000的报错
• 本地运行正常是因为本地的PostgreSQL版本大概率低于12，旧驱动可以适配，和QA环境存在版本差异

修复步骤 #

1. 升级PostgreSQL JDBC驱动版本
   将pom文件中org.postgresql的依赖版本升级到42.2.23及以上的稳定版，该版本完全兼容PostgreSQL 12、Java 11以及Hibernate 5.4.x的调用要求。
2. 修正Hibernate方言配置
   检查Hibernate配置中的方言参数，将旧版本的方言替换为适配PG12的版本：
   org.hibernate.dialect.PostgreSQL12Dialect
   避免Hibernate生成PG12不支持的SQL语法，同时适配新驱动的特性。
3. 检查数据库连接配置
   确认QA环境的数据库连接参数没有配置仅旧版驱动支持的废弃参数，移除不兼容的配置项。
4. 本地预验证
   修复完成后，可以在本地部署PostgreSQL 12.2实例，复用QA环境的配置进行连接测试，先验证修复效果再部署到QA环境，规避环境差异问题。

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