解决 IDEA 或 DataGrip 连接数据库问题：设置 JVM IPv4 参数

如何解决 IDEA/DataGrip 无法连接数据库的问题

引言

在开发过程中，我们常常使用集成开发环境（IDE）如 IntelliJ IDEA 或 JetBrains DataGrip 来与数据库进行交互。然而，有时可能会遇到无法连接数据库的情况，尤其是当使用新版的 IDEA 或 DataGrip 时。这种问题通常是由于网络配置或者 IDE 与数据库之间的兼容性问题引起的。

一种常见的解决办法是添加 JVM 参数 -Djava.net.preferIPv4Stack=true，以优先使用 IPv4 协议栈。这种方式能够有效解决因 IPv6 配置问题导致的数据库连接失败问题。本文将详细介绍如何通过修改 IDEA 或 DataGrip 的启动参数来解决这个问题。

1. 问题的症状

当尝试通过 IDEA 或 DataGrip 连接数据库时，可能会遇到以下错误信息：

• 连接超时
• 无法解析主机名
• 无法连接到数据库
• 数据库连接失败，网络不可达

这些问题往往出现在 IPv6 配置不正确的情况下，或者当默认网络协议栈选择了 IPv6 时。

2. 问题的根源

Java 运行时环境（JRE）默认使用的是 IPv6 协议栈，但并不是所有的数据库服务器和网络配置都完全支持 IPv6。某些数据库（特别是在某些企业环境中）只支持 IPv4 或者对 IPv6 的支持不稳定。因此，JVM 在尝试连接数据库时，可能会因为 IPv6 的支持不完善而导致连接失败。

3. 解决方法：添加 -Djava.net.preferIPv4Stack=true

为了解决这个问题，可以通过设置 JVM 启动参数来强制使用 IPv4 协议栈。这样，无论系统网络环境是否支持 IPv6，JVM 都会优先选择 IPv4 来建立连接。

具体步骤如下：

3.1. 对于 IntelliJ IDEA

1. 打开 IntelliJ IDEA 设置页面
   • 启动 IntelliJ IDEA，点击菜单栏中的 File → Settings（对于 macOS 是 IntelliJ IDEA → Preferences）。
2. 进入 VM 选项设置
   • 在设置窗口中，选择 Build, Execution, Deployment → Build Tools → Gradle。
3. 保存并重启 IDEA
   • 点击 OK 保存设置并关闭设置窗口，然后重启 IDEA，使更改生效。

在 Gradle 部分的 VM options 字段中添加以下内容：

-Djava.net.preferIPv4Stack=true 

3.2. 对于 JetBrains DataGrip

1. 打开 DataGrip 配置文件
   • 在安装目录下找到 DataGrip 的配置文件 datagrip.vmoptions。路径可能会因操作系统的不同而有所不同：
     • Windows: C:\Users\<your-user>\AppData\Roaming\JetBrains\DataGrip<version>\datagrip.vmoptions
     • macOS: /Applications/DataGrip.app/Contents/bin/datagrip.vmoptions
     • Linux: