MySQL Workbench反复无法重连AWS RDS MySQL实例问题求助

最高概率根因 #

报错提示为Unable to connect to localhost，但AWS RDS的官方访问地址并非localhost，说明连接依赖本地中间转发层，转发层失效导致故障：

• 首次配置连接时开启了SSH隧道、AWS SSM端口转发或本地代理，将RDS的3306端口映射到了本地localhost的3306端口，MySQL Workbench内配置的连接地址实际为本地映射地址，而非RDS官方Endpoint
• 电脑休眠、网络切换、工具重启都会导致端口映射失效，此时Workbench请求本地端口自然失败，与RDS运行状态、数据库凭证无关
• 删除实例、重装软件的操作相当于重置了连接配置，首次恢复时重新开启了端口映射，所以临时恢复正常，第二天映射失效后问题复现

低概率诱因 #

• M1芯片适配的MySQL Workbench历史版本存在bug，8.0.29及之前的版本会偶发自动清空已保存的连接地址，默认重置为localhost
• RDS安全组入站规则绑定了动态公网IP，ISP分配的公网IP次日变更后被安全组拦截，该场景常规报错为连接超时，可作为辅助排查项

修复方案 #

• 打开MySQL Workbench连接配置页，确认连接地址填写的是AWS RDS控制台提供的官方Endpoint，而非127.0.0.1/localhost
• 如必须使用端口转发连接RDS，可将端口转发命令配置为开机自启脚本，避免设备重启/休眠后映射失效
• 升级MySQL Workbench至8.0.33及以上版本，修复M1芯片下的连接配置自动重置bug
• 将RDS安全组入站规则绑定固定IP段，或使用AWS IAM身份验证替代IP白名单，避免动态IP导致的连接异常

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