Java程序连接KingbaseES 异常

错误信息：

--KStudio客户端工具错误信息
The conncetion attempt failed.Reason:connect time out

--Java应用程序控制台日志
Caused by :java.net.SocketTimeoutException: connect time out
 at java.net.DualStackPlainSocketImpl.waitForConnect(Native Method)
 at java.net.DualStackPlainSocketImpl.socketConnect(Unknown Source)

问题现象：

Navicat客户端工具可以正常连接KingbaseES数据库，Navicat客户端工具连接数据库未使用jdbc驱动。而使用jdbc驱动的Java应用程序及KStudio客户端工具不能正常连接KingbaseES数据库。

排查过程：

同样是远程跨主机访问数据库，Navicat客户端工具连接数据库未使用jdbc驱动程序，可以正常连接KingbaseES数据库，说明问题原因跟网络和防火墙没有关系。

通过Java应用程序控制台日志发现客户端/应用程序在尝试使用IPv6，但是网络环境不支持IPv6，所以无法建立连接。

Caused by :java.net.SocketTimeoutException: connect time out
 at java.net.DualStackPlainSocketImpl.waitForConnect(Native Method)
 at java.net.DualStackPlainSocketImpl.socketConnect(Unknown Source)

通过以下网址得知，在使用VPN连接的环境部分VPN软件会导致Java应用jdbc驱动默认使用IPv6，不使用IPv4。

https://docs.oracle.com/javase/7/docs/webnotes/tsg/TSG-Desktop/html/plugin.html

Network Configuration

In general, Java Web Start applications use the system network configuration by default, and applets use the browser network settings. You can set network proxies explicitly using Java Control Panel.

In particular, the Java technology networking layer automatically detects what networking stack to use. However, sometimes autodetection does not work and you may observe "Permission Denied" exceptions trying to open a socket to download your application or applet, even while the same URL is accessible using the same proxy settings with other tools. This problem was observed on some Windows 7 systems when VPN software is used. This can be resolved by explicitly passing a parameter to the JVM:

-Djava.net.preferIPv4Stack=true
See the section on how to pass parameters to JVM for details.

通过询问同事得知，连接有问题的环境确实有在使用VPN(Easy connect )软件。

在Java代码添加System.setProperty("java.net.preferIPv4Stack","true"); 添加后可以正常运行Java应用。

到此基本可以确定，问题出现原因主要就是由于使用VPN软件导致不能正常建立IPv6连接，Java程序又尝试使用IPv6导致。

可以通过显式设置jvm参数 -Djava.net.preferIPv4Stack=true，使Java应用程序优先使用IPv4来解决此问题。

解决方法：

在KStudio客户端工具配置文件kstudio.ini 加入 -Djava.net.preferIPv4Stack=true 问题解决。

Java应用程序解决方法：

1. 禁用系统IPv6.

2. 设置Java系统属性

   在Java应用程序代码里面添加 System.setProperty("java.net.preferIPv4Stack","true");
   使用java -jar 启动Java应用时，增加参数 -Djava.net.preferIPv4Stack=true
   设置环境变量_JPI_VM_OPTIONS和_JAVA_OPTIONS -Djava.net.preferIPv4Stack=true
   设置开发工具IDEA 的vm options -Djava.net.preferIPv4Stack=true
   

3. 添加环境变量

   windows系统 set "JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true"
   Linux系统   export _JAVA_OPTIONS="-Djava.net.preferIPv4Stack=true"
   

关于参数 java.net.preferIPv4Stack

官方文档解释：

If IPv6 is available on the operating system, the underlying native socket will be an IPv6 socket. This allows Java applications to connect to, and accept connections from, both IPv4 and IPv6 hosts.

java.net.preferIPv4Stack=false

在支持IPv6的双栈系统上，使用Java的Socket会默认通过底层native方法创建一个IPv6 Socket，这个IPv6 Socket可以同时支持和IPv4或IPv6主机通信。

java.net.preferIPv4Stack=true

如果设置为true，Java程序将无法使用IPv6进行网络通信，也就是仅支持IPv4。通过IPv6访问就会访问不通。

通过以下代码获取默认优先使用IPv4还是IPv6

System.out.println(InetAddress.getByName("[www.aliyun.com](http://www.aliyun.com)"));