DataGrip 连不上 MySQL

报错只有一句 Attempted reconnect 3 times. Giving up.,
服务器、账号密码、驱动全部正常,问题最终定位在谁也没想到的地方——深信服 aTrust 的隧道驱动不支持 Java 的 IPv6 双栈 socket。

一、事发

用 DataGrip 连公司测试库(内网地址,形如 10.x.x.x:400xx,库名、密码略,必须挂公司零信任客户端 aTrust 才能访问):

DBMS: MySQL (版本 8.0.41)
区分大小写: 普通形式=mixed,分隔形式=exact
Cannot assign requested address: connect.

注意一个细节:数据源卡片显示 "MySQL(无版本)"——说明连接连握手都没完成,问题大概率不在认证阶段。

二、排除服务端

用 Python 写个最小脚本直接连:

import pymysql
conn = pymysql.connect(host="10.x.x.x", port=400xx,
                       user="****", password="****", connect_timeout=8)

一次通过:MySQL 8.0.x,密码正确,目标库存在。再强制走严格 TLS,也正常。

结论:网络通、密码对、SSL 正常,问题 100% 出在 DataGrip 所在的 Windows 客户端。

三、被误导的线索

DataGrip 界面上看不到底层异常,翻 idea.log 找到一行:

[08S01] The driver was unable to create a connection due to an inability
to establish the client portion of a socket.
... see Microsoft Knowledge Base Article 196271 (Q196271).

它指向"Windows 临时端口耗尽"——但实测本机 TIME_WAIT 只有 112 个、端口范围是默认值,毫无异常。而且这次失败发生在 95 毫秒以内,本地立即失败,根本来不及超时。

教训:错误信息里的"常见原因"只是最常见的原因,不是你的原因。

四、复现,拿到真凶

用 DataGrip 自带的 JBR 和驱动 jar 在命令行跑同样的连接(排除 IDE 配置干扰):

"C:\...\DataGrip\jbr\bin\java.exe" ^
  -cp "...\mysql-connector-j-9.7.0.jar" JdbcTest.java

完美复现,这次拿到完整异常链,真凶在最底层:

java.net.BindException: Cannot assign requested address: getsockopt
    at java.base/sun.nio.ch.Net.pollConnect(Native Method)
    ...
    at java.base/java.net.Socket.connect(Socket.java:659)

再用裸 socket 测试剥离 JDBC 层,出现了两个关键事实:

  • Java 连内网目标必败,连回环正常(Connection refused 是正常的"没监听");
  • Java 连公网地址却完全正常,本地地址就是真实网卡 IP。

也就是说:Java 不是"完全不能联网",而是"走 VPN 隧道的流量必败"。

五、根因:VPN 隧道驱动只认 IPv4 socket

关键知识点:

Python 创建的是纯 IPv4 socket(AF_INET);而 JVM 在 Windows 上默认创建 IPv6 双栈 socket(AF_INET6),即使目标是 IPv4 地址,底层也走 IPv4-mapped(::ffff:x.x.x.x)。

查路由表真相大白——aTrust 做的是分流隧道:

10.16.0.0/23   -> aTrustVNIC   (内网网段走隧道)
10.16.100.0/24 -> aTrustVNIC
172.16.0.0/16  -> aTrustVNIC
其他            -> WLAN 直连   (所以公网访问不受影响)

aTrust 的隧道驱动只实现了 IPv4 socket 的收发,对 IPv6 家族 socket(包括 v4-mapped)不分配源地址,内核直接返回 WSAEADDRNOTAVAIL——就是 Java 看到的 Cannot assign requested address。Python 走 AF_INET,全程无感。

顺带一提:排查中曾一度怀疑"系统 IPv6 协议栈损坏"(注册表里确有 DisabledComponents=0x20,网卡 IPv6 绑定也被关了),修复后依然失败——那只是个路过的痕迹,真正的拦截发生在隧道驱动层,系统层面无解。

验证:加参数强制 Java 走纯 IPv4,立刻成功:

java -Djava.net.preferIPv4Stack=true JdbcTest.java   # OK

六、修复

DataGrip 加一个 JVM 参数(推荐)

Help → Edit Custom VM Options...,末尾加一行:

-Djava.net.preferIPv4Stack=true

完全退出并重启 DataGrip。只影响它自己的 JVM,对系统零副作用,也不影响其他走直连的网络行为。

根治只能指望 VPN 侧:让 IT 在 aTrust 策略里放行 java.exe,或等客户端更新支持 IPv6 家族 socket——在此之前,上面的参数就是最优解。

七、番外:为什么重装系统前不用配参数?

这个问题我也追查了。先说前提:这台机器访问数据库全程走 aTrust 隧道(tracert 第二跳就是隧道网段的 14.1.0.254),并不是直连。

但重装系统把三个变量同时换掉了:Windows 版本、DataGrip(含其自带的 JBR)版本、aTrust 客户端版本,老环境已无法取证。能确定的是现在的机制;至于老环境是"老 JBR 的默认行为不同"还是"老版 aTrust 驱动兼容 IPv6 双栈 socket",两种可能都存在——只要老环境里的 Java 实际走的是纯 IPv4 socket,隧道就完全无感,一切正常。

顺带回答一个高频疑问:这里用的 Java 是 DataGrip 自带的私有运行时 JBR(安装目录\jbr\bin\java.exe),跟系统的 JAVA_HOME 无关。日志里每次测试连接都会拉起一个 RemoteJdbcServer 子进程,命令行里的 java 路径就是证明。所以 VM Options 里加参数只影响 DataGrip 自己,不影响系统里其他 Java 程序;反过来,其他 Java 程序若遇到同样问题,需要各自加同样的参数。

八、复盘

最短排查路径:

  1. 看版本号——"无版本"说明握手都没完成,直接跳过密码/权限类怀疑;
  2. 用第三方工具验证服务端,一刀切开"服务端 vs 客户端";
  3. 拿到真实异常栈——autoReconnect=true 会把真实报错包装成"重试 3 次放弃";
  4. 用软件自己的零件命令行复现(JBR + 官方驱动 jar),排除 IDE 配置层;
  5. 裸 socket 测试把问题压到网络层,再对比"隧道内 vs 隧道外"的目标地址——范围一划,元凶自现。

三条冷知识:

  • MySQL 8 非 SSL 连接时 DataGrip 常报 Public key retrieval is not allowed,URL 加 allowPublicKeyRetrieval=true;
  • JDBC 的 autoReconnect 在新驱动里已废弃,只会掩盖真实报错;
  • Java 默认用 IPv6 双栈 socket,企业 VPN/加速器的隧道驱动只实现 IPv4 时,症状就是"Java 走隧道的流量全挂,Python 等 IPv4 应用一切正常"——见到 Cannot assign requested address 先分流量问一句:哪些目标地址走的是隧道?

环境:DataGrip 2026.2(mysql-connector-j 9.7.0 / JBR 25)、Python + pymysql、Windows 11、Sangfor aTrust。