Spring Boot连接K8s上的AWS MySQL报Communications link failure如何解决

com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure 报错的核心原因是JDBC驱动无法和MySQL实例完成TCP连接建立，和安装阶段配置的AK/SK没有直接关系——注意：安装配置阶段填写的access keyId和secret key是供MySQL实例调用AWS云资源API（比如挂载持久化存储、拉取备份、上传日志）使用的，不是MySQL数据库本身的登录认证凭证，不要把这组密钥填到JDBC连接的用户名密码字段中。

按以下优先级逐一排查修复：

• 第一步：验证Pod到数据库的基础网络连通性
  进入Spring Boot应用所在的K8s Pod内直接测试端口连通性，不要在本地或集群节点上测试，避免网段差异导致误判：

  kubectl exec -it <你的应用Pod名称> -- nc -zv <MySQL实例连接地址> 3306
  

  如果端口不通，依次排查：
  • MySQL实例所属安全组、网络ACL是否放通K8s集群的Pod网段、节点网段的3306端口入站流量
  • 如果使用AWS RDS/自托管在K8s的MySQL，确认实例没有只绑定127.0.0.1回环地址，监听的是对外可访问的网卡地址
  • 若K8s集群配置了NetworkPolicy，检查规则是否允许应用Pod所在Namespace向MySQL地址发起3306端口出站连接
  • 若MySQL部署在K8s集群内，核对Service的端口映射、TargetPort配置是否和MySQL实际监听端口一致，不要误用Service的ClusterIP/端口
• 第二步：核对JDBC连接配置
  网络连通正常的情况下，配置错误也会触发同类报错：
  • 检查JDBC URL格式是否正确，参考标准格式：

    jdbc:mysql://<MySQL连接地址>:3306/<业务库名>?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true
    

    注意不要写错端口、库名，URL前后不要带多余空格
  • 确认数据库登录凭证是MySQL内部创建的业务账号密码，不是安装阶段填的AWS AK/SK
  • 如果使用MySQL 8.0及以上版本，确认引入的mysql-connector-java驱动版本匹配，同时把驱动类名从旧版的com.mysql.jdbc.Driver替换为com.mysql.cj.jdbc.Driver
• 第三步：排查数据库侧连接限制
  • 登录数据库执行show processlist;和show variables like 'max_connections';，如果当前连接数已经达到max_connections上限，新连接会被直接拒绝，需要调大连接数阈值或清理闲置连接
  • 如果数据库前端挂载了RDS Proxy、ProxySQL等代理层，检查代理的监听端口、访问白名单、超时配置是否正常
• 第四步：排查流量拦截组件
  如果应用Pod注入了Istio、Linkerd等Service Mesh边车，临时关闭边车注入重新部署应用测试，确认是否是边车的流量策略拦截了3306端口的出站请求。

内容的提问来源于stack exchange，提问作者Thomas Ngo