GaussDB(DWS)JDBC连接报错案例集锦

GaussDB(DWS)JDBC连接报错案例集锦

• 【问题描述】

客户端连接数据库报错Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.

【问题分析】

可能原因为客户端与服务端网络不通、或端口错误、或待连接cn异常，可逐项排查具体是哪种情况：

• 客户端ping服务端IP，看网络是否畅通，网络不通则解决网络问题；
• 检查url中连接cn的端口是否正确，端口不正确修改为正确的端口；
• 登录cn所在机器，cm_ctl -vC排查待连接cn状态是否正常。

【解决方案】

参见问题分析。

• 【问题描述】

客户端连接数据库报错FATAL: Invalid username/password,login denied. 

【问题分析】

用户名或密码配置错误。

【解决方案】

将连接数据库的用户密码修改正确。

• 【问题描述】

客户端连接数据库报错No suitable driver found for XXXX  

【问题分析】

URL格式书写错误。

【解决方案】

将url格式修改为正确的格式

gsjdbc4.jar对应 jdbc:postgresql://host:port/database，

gsjdbc200.jar对应jdbc:gaussdb://host:port/database。

• 【问题描述】

客户端连接数据库报错FATAL: no pg_hba.conf entry for host 

【问题分析】

未在待连接cn的pg_hba.conf文件中给客户端机器开通白名单。

【解决方案】

在待连接cn的pg_hba.conf文件中按需添加host all all 0.0.0.0/0 sha256开通所有客户端机器白名单或仅为本客户端开通。

• 【问题描述】

客户端连接数据库报错conflit

【问题分析】

JDBC jar包和应用程序冲突。

【解决方案】

将gsjdbc4.jar替换为gsjdbc200.jar

• 【问题描述】

客户端连接数据库报错org.postgresql.util.PSQLException: FATAL: terminating connection due to administrator command

Session unused timeout

【问题分析】

会话超时导致连接断开。

【解决方案】

排查cn和客户端jdbc上的超时配置，按业务实际情况调长超时时间或关闭超时设置。

• 【问题描述】

客户端连接数据库报错SSL error: Connection reset

【问题分析】

操作系统配置了走ssl认证。

【解决方案】

在启动程序之前执行一下export PGSSLMODE="prefer" 或者export PGSSLMODE="allow"，如果仍然报错则可通过关闭ssl认证规避。

• 【问题描述】

同一台客户端电脑，通过datastudio可以连上数据库，但通过一个第三方的工具datagrip连接报错：Connection refused: connect.

【问题分析】

第三方工具的默认驱动不兼容。

【解决方案】

更换为华为提供的jdbc驱动包后可正常连接。

• 【问题描述】

客户端连接数据库报错Connections could not be acquired from the underlying database!

【问题分析】

现场按新建连接排查项进行排查: 

1.驱动配置有误：driver=com.GuassDB.jdbc.Driver

2.数据库连接地址有误：

3.密码或帐号有误：

4.数据库未启动或无权访问

5.项目未引入对应的驱动jar包

6.没有远程访问的权限，需要增加白名单

经排查确认是没有配置白名单

【解决方案】

在cn端配置白名单后可正常连接。