YashanDB 知识库|DBeaver 连接不上数据库?一招教你排查!

在实际部署使用 YashanDB 后，有些用户在通过 DBeaver 工具连接数据库时，遇到无法访问的问题。别急，这类问题一般排查起来并不复杂，跟着这份指南操作，很快就能搞定!

一、问题现象

数据库部署完成后，尝试使用 DBeaver 连接，却提示连接失败，无法正常访问。

二、可能原因分析

常见的导致 DBeaver 无法连接 YashanDB 的原因主要有两个方面：

1. 网络连通问题

首先需要通过 ping 或 telnet 命令，确认客户端和数据库服务器之间的网络是否畅通。

如果网络不通，很可能是因为数据库监听的网段配置不完整，导致监听端口无法对外开放。

2. JDK 版本问题

如果网络是正常的，但连接仍然失败，尤其是使用较新版本 JDK(如 JDK 17、JDK 21)的情况下，很可能是 JVM 默认启用了 IPv6 网络协议，而 YashanDB 目前对 IPv6 支持有限。

这时，DBeaver 在连接数据库时，可能因为 IPv6 优先策略导致连接异常。

三、解决方法

针对 IPv6 引起的问题，可以通过修改 DBeaver 的 JVM 启动配置来规避。

具体操作如下：

1、找到 DBeaver 安装目录下的 dbeaver.ini 或 dbeaver.conf 配置文件;

2、在 JVM 参数中，增加如下一行配置：

-Djava.net.preferIPv4Stack=true
注意：=true 中间不要有空格，确保拼写正确。

保存文件后，重启 DBeaver，再次尝试连接数据库，问题即可解决。

四、适用范围说明

此问题影响 所有版本的 YashanDB;

适用于使用 DBeaver 作为客户端工具连接数据库的场景。

五、小结提醒

遇到连接失败，先确认网络，再检查客户端配置;

使用高版本 JDK 时，注意 IPv6/IPv4 协议栈兼容问题;

在配置中显式指定优先使用 IPv4.可以避免很多隐性连接问题。