实战笔记丨JDBC问题定位指南

JDBC（Java数据库连接性）是Java API，用于管理与数据库的连接，发出查询和命令以及处理从数据库获得的结果集。JDBC在1997年作为JDK 1.1的一部分发布，是为Java持久层开发的首批组件之一。

JDBC问题基础知识

JDBC问题是指比较宽泛的，体现在JDBC层面的问题，造成JDBC问题的原因主要是三个方面：1、应用程序和应用程序框架问题；2、JDBC业务功能问题；3、数据库内核问题。问题表现可以分为三个大的方面：1、执行报错，JDBC抛出异常；2、执行效率低，耗时异常；3、特性不支持，JDBC未实现的JDK接口。

JDBC问题分类

JDBC问题定位方法及解决措施

建立数据库链接失败

1、 关键字：Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.  客户端ping服务端IP，看网络是否畅通，网络不通首先解决网络问题，然后查看端口是否正确，端口不正确修改为正确的端口；

2、 关键字：FATAL: Invalid username/password,login denied.  检查用户名密码的配置是否正确。措施：将其修改为正确的用户名密码。

3、 关键字：No suitable driver found for XXXX   检查URL格式是否正确, 措施：将其修改为正确的格式gsjdbc4.jar对应 jdbc:postgresql://host:port/database， gsjdbc200.jar对应jdbc:gaussdb://host:port/database。

4、 关键字：FATAL: no pg_hba.conf entry for host  检查所链接CN是否配置远程访问权限，在cn下的pg_hba.conf文件中添加host all all 0.0.0.0/0 sha256。

5、 关键字：conflit   JDBC jar包和应用程序冲突，措施：将gsjdbc4.jar替换为gsjdbc200.jar

执行业务抛异常

1、 关键字：receiveErrorResponse 若报错中含有次关键字，则JDBC报错是接收到了内核发来的异常报文和异常信息， 措施：需要收集相关报错及日志信息发回研发分析。

2、 关键字：Broken pipe, connection reset by peer 可能原因：网络故障，数据库链接超时,措施：检查网络状态，修复网络故障，影响数据库链接超时的因素，数据库参数session_timeout以及lvs 

3、 关键字：The column index is out of range 可能原因：应用程序获取的结果集和预期不一致，列数不一致，应用程序问题 措施：检查数据库表定义和查询sql，对返回结果集做一个正确预期，若结果集只有3列，取值时传入的index最大为3。

性能问题

1、 设置loglevel=3，打开jdbc日志，若主要耗时在processResult阶段，可分为两种情况：1）jdbc端一直等待内核返回的报文，等待时间较长； 判断方法：查看FE=> Syncr日志和<=BE ParseComplete日志之间的时间间隔，若时间间隔较久，则判断是内核执行慢；措施：需要内核人员分析sql执行慢的原因；2）结果集过大，一次性全部加载，消耗大量时间；判断方法：看日志若<=BE DataRow出现次数特别多，或则直接在gsql里执行select count(*)查询出来的数目特别大，则判断是结果集过大； 措施：设置fetchSize参数为一个较小的值，使数据按批次返回，客户端得到快速响应。

2、 若主要耗时在modifyJdbcCall（校验传入的sql是否符合规范）和createParameterizedQuery（将传入的sql解析为preparedQuery,以获取由simplequery组成的subqueries）阶段，则需要看一下传入的sql是不是过长，措施：jdbc本身没办法优化这部分耗时，需要应用端看下是否可以优化传入的sql。

功能问题

1、 关键字：not yet implemented ，JDBC未实现接口，措施：需要研究一下是否可实现，是否需要落需求，或则是否有其他接口已提供相同功能，调整业务使用已提供接口 

2、 JDK标准接口中未提供功能，JDK未提供标准接口，措施：理论上，JDK未提供接口，JDBC不支持，实际使用中可以使用JDBC类中的public方法获取部分过程数据，绝大部分情况下明确不支持。

常见案例

加载驱动失败

客户在使用JDBC的时候往往不是直接通过Java程序加载驱动建立链接，而是通过应用程序框架，做好配置之后通过应用程序框架自动建立链接，可能会由于配置问题导致建立链接失败，如：使用了gsjdbc200.jar，但是加载的驱动仍然是org.postgresql.Driver后者使用的url格式仍然是jdbc:postgresql，由于是应用程序框架加载的，所以有些时候驱动路径和url格式都是固定的，只允许配置ip、port、user、password等基本信息，并且在出错的时候只能看见建立链接失败的log信息，看不见堆栈。 

解决措施：1、首先应该检查用户使用的jdbc驱动是gsjdbc4.jar还是gsjdbc200.jar，若是gsjdbc200.jar应该替换为gsjdbc4.jar，尝试建立链接。2、排除JDBC嫌疑，写一个Java测试用例，不通过应用程序架构，通过Java程序直接加载驱动，建立链接，在排除jdbc嫌疑之后再去细致研究应用程序框架，以解决问题。

JDBC jar包冲突

多个局点曾报出类冲突问题，都是由于JDBC和应用程序拥有相同路径相同名称的类导致，大体可以分为两类，一是gsjdbc4.jar和开源postgresql.jar冲突，两者具有完全相同的类名，二是gsjdbc4.jar 由于iam特性引入了一些其他工具，例如fastjson，和应用程序中的fastjson冲突；

解决措施：针对和开源postgresql.jar的冲突，我们提供了gsjdbc200.jar，使用和开源驱动不同的url格式和驱动路径，驱动名由org.postgresql.Driver修改为com.huawei.gauss200.jdbc.Driver，url格式由org:postgresql://host:port/database改为jdbc:gaussdb://host:port/database，彻底解决了和开源jar包的冲突；针对JDBC引入的jar和应用程序中引入jar的冲突，我们通过maven的shade修改了jar里类的路径，解决了这类冲突。