AWS Glue连接外部MariaDB出现通信链路故障的排查求助

尝试通过AWS Glue Spark脚本及JDBC Glue连接访问外部MariaDB数据库实例，使用的代码片段如下：

dyf = glueContext.create_dynamic_frame.from_options( 
connection_type = 'mysql', connection_options = 
{ 
 "useConnectionProperties": "true",
 "connectionName": "sample_con_name",
 "dbtable": "admins",
 "customJdbcDriverS3Path": "s3://path_to_connector/mysql-connector-java-8.0.17.jar",
 "customJdbcDriverClassName": "com.mysql.cj.jdbc.Driver"
 } 
)

运行Glue Spark作业时出现错误：

An error occurred while calling o95.getDynamicFrame. Communications link failure

环境背景：

• Glue连接基于VPC内的私有子网，私有子网通过VPC中的NAT网关路由
• NAT网关绑定的弹性IP已被外部数据库管理员加入白名单
• 同一私有子网内的EC2实例通过PHP脚本可成功连接该外部数据库

疑问：如何修复此问题？是否为驱动或证书问题？

1. 核对Glue作业的VPC网络配置 #

• 确认Glue作业关联的VPC、私有子网、安全组和能连通的EC2完全一致，安全组必须允许出站访问MariaDB的端口（默认3306，自定义端口需对应）。
• 检查Glue作业所用IAM角色的权限，确保包含ec2:CreateNetworkInterface、ec2:DeleteNetworkInterface等VPC资源操作权限，否则Glue无法创建弹性网卡实现VPC内网络访问。

2. 调整JDBC驱动适配MariaDB #

• 替换为MariaDB官方驱动：MySQL驱动虽兼容部分场景，但高版本MariaDB（10.2+）更适配官方驱动。比如用mariadb-java-client-2.7.5.jar，对应驱动类名org.mariadb.jdbc.Driver，更新代码里的customJdbcDriverS3Path和customJdbcDriverClassName参数。
• 验证驱动版本匹配：如果坚持用MySQL驱动，确认版本和目标MariaDB兼容（比如MySQL 8.0驱动适配MariaDB 10.3+，旧版本可能存在握手协议不兼容）。

3. 补充JDBC连接参数 #

• 强制SSL配置（若数据库要求）：在connection_options中添加SSL相关参数，示例：

  "sslMode": "REQUIRED",
  "trustCertificateKeyStoreUrl": "s3://your-bucket/truststore.jks",
  "trustCertificateKeyStorePassword": "your-store-password"
  

  若数据库用自签名证书，需先将证书导入Java信任库，上传到S3并确保Glue角色有该S3路径的读取权限。
• 添加超时与重试参数：缓解网络波动影响，添加：

  "connectTimeout": "30000",
  "socketTimeout": "60000"
  

4. 验证Glue连接本身的正确性 #

• 在Glue控制台进入连接详情页，点击「测试连接」，选择同VPC的Glue开发端点或作业角色，快速排查是连接配置错误还是作业代码问题。
• 确认Glue连接中填写的数据库端点、端口、用户名密码完全正确，没有多余空格或格式错误。

5. 深层网络排查 #

• 核对私有子网路由表：确认0.0.0.0/0的下一跳是正常运行的NAT网关，无路由配置错误。
• （可选）抓包对比：在同子网EC2上抓包记录成功连接的数据包，对比Glue作业的网络日志（CloudWatch中查看），确认是否存在数据包丢失或端口不通的情况。

内容的提问来源于stack exchange，提问作者Abhishek Dutta