从Google Dataflow连接AWS RDS MySQL实例失败求助

刚碰到过几乎一模一样的问题，给你梳理几个最容易踩坑的排查点，按优先级试试：

1. 先搞定最核心的网络连通性 #

这是90%这类问题的根源：

• AWS RDS安全组规则：一定要把Dataflow作业所在的IP范围（或者临时放开0.0.0.0/0做测试）加入到RDS安全组的入站规则，允许3306端口的TCP流量。如果Dataflow用的是GCP的VPC网络，要么配置GCP和AWS的VPC对等连接，要么用Cloud NAT让Dataflow Worker有公网IP访问RDS。
• RDS公有可访问性：在RDS控制台确认这个选项设为「是」，如果是私有子网部署的RDS，得确保Dataflow能打通到那个私有网络的路由。

2. 检查JDBC URL的细节 #

别小看配置的小错误：

• 正确的URL格式应该是：

  jdbc:mysql://<your-rds-endpoint>:3306/<db-name>?useSSL=true&serverTimezone=UTC&sslMode=REQUIRED
  

  AWS RDS默认要求SSL连接，所以useSSL和sslMode参数不能少；另外时区参数serverTimezone也容易忽略，不设置可能导致连接超时。
• 注意endpoint别写错，RDS的端点是类似xxx.xxxx.us-east-1.rds.amazonaws.com的完整域名，别漏了后缀。如果密码里有特殊字符（比如@、&），要做URL转义，比如用%40代替@。

3. 确认Dataflow的依赖打包正确 #

Dataflow Worker的环境和本地不一样，很容易出现驱动缺失：

• 确保你用的MySQL JDBC驱动版本和RDS的MySQL版本匹配：比如RDS是MySQL 8.0+，就用mysql-connector-java:8.x版本，别用5.x的旧驱动，兼容性问题会直接导致连接失败。
• 打包作业时，要把JDBC驱动包包含进去。如果用Maven，要么把驱动依赖设为compile范围，要么用maven-shade-plugin打fat jar，不然Dataflow Worker找不到驱动类，也会报通信错误。

4. 验证数据库账号权限 #

有时候账号的访问限制会伪装成连接问题：

• 执行SQL给账号开全局访问权限（测试用，之后再收窄）：

  GRANT ALL PRIVILEGES ON <db-name>.* TO '<your-user>'@'%';
  FLUSH PRIVILEGES;
  

  确认账号能从非本地IP访问RDS，避免因为@localhost或者特定IP限制导致的连接失败。

快速测试技巧 #

先在本地用完全相同的JDBC配置连接RDS：

• 如果本地能连上，说明问题出在Dataflow的网络、打包配置上；
• 如果本地也连不上，那直接排查RDS的安全组、账号配置就行。

内容的提问来源于stack exchange，提问作者A Kong