谷歌云MySQL私有IP连接失败：Spring应用通信链路异常排查

看起来你遇到的情况很典型：相同的私有IP连接配置，mysql客户端和普通托管服务器能正常连接，但JBoss上的Spring应用却抛出通信链路失败的错误。结合你给出的错误日志（Communications link failure，驱动未收到服务器数据包），我整理了几个针对性的排查和解决方向：

1. 检查JDBC URL的关键参数 #

MySQL 8.0+驱动有几个容易被忽略的参数，尤其是在JBoss这类容器环境中：

• 添加上allowPublicKeyRetrieval=true：这个参数允许驱动从服务器获取公钥，否则当服务器要求密码加密时会连接失败（mysql客户端可能自动处理了这个逻辑，但JBoss连接池不会）。
• 明确设置useSSL=false（如果你的私有IP连接不需要SSL）：Google Cloud MySQL的私有IP连接默认可以不用SSL，但有些驱动版本会强制尝试SSL连接，导致握手失败。
• 加上serverTimezone=UTC：避免时区不匹配引发的隐性连接问题。

调整后的JDBC URL示例：

jdbc:mysql://your-private-ip:3306/academy?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC

2. 验证JBoss的数据源配置完整性 #

确保你的JBoss数据源配置（standalone.xml/domain.xml）正确关联了MySQL驱动，并且配置了合适的连接池验证规则：

<datasource jndi-name="java:jboss/datasources/ACADEMY" pool-name="ACADEMY" enabled="true" use-java-context="true">
    <connection-url>jdbc:mysql://10.xxx.xxx.xxx:3306/academy?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC</connection-url>
    <driver>mysql</driver>
    <security>
        <user-name>your-db-username</user-name>
        <password>your-db-password</password>
    </security>
    <!-- 添加MySQL专属的连接验证和异常处理 -->
    <validation>
        <valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker"/>
        <validate-on-match>true</validate-on-match>
        <exception-sorter class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter"/>
    </validation>
</datasource>

<drivers>
    <driver name="mysql" module="com.mysql">
        <driver-class>com.mysql.cj.jdbc.Driver</driver-class> <!-- MySQL 8.0+的驱动类 -->
        <xa-datasource-class>com.mysql.cj.jdbc.MysqlXADataSource</xa-datasource-class>
    </driver>
</drivers>

同时确认你已经把MySQL驱动jar包放到了JBoss的modules/com/mysql/main目录下，并且module.xml配置正确。

3. 排查JBoss服务器的网络/防火墙限制 #

虽然你能通过mysql客户端连接，但要确认JBoss进程所在的网络上下文是否和客户端一致：

• 在JBoss服务器上执行nc -zv your-private-ip 3306，测试是否能正常访问MySQL端口。如果不通，说明服务器的防火墙/iptables规则阻止了JBoss的Java进程访问3306端口，需要添加放行规则。
• 如果是容器化部署的JBoss（比如Docker或Kubernetes），检查容器的网络模式：是否使用了host网络，或者容器所在的网络是否有权限访问Google Cloud的VPC私有IP（比如GKE的VPC-native模式）。

4. 确认Google Cloud VPC和MySQL实例配置 #

• 检查应用服务器和MySQL实例是否在同一个VPC网络，或者通过VPC peering正确连接。
• 验证MySQL实例的防火墙规则：是否允许应用服务器的私有IP段访问3306端口（注意：mysql客户端的IP可能和JBoss服务器的IP不在同一个允许列表里）。

如果以上步骤都排查过，还是无法解决，可以尝试在JBoss的启动参数中添加-Djavax.net.debug=all，开启网络调试日志，这样能更详细地看到连接过程中的SSL握手或数据包传输问题，进一步定位根源。

内容的提问来源于stack exchange，提问作者Narasimha Prasad