文档中心

云数据库 MySQL 版

连接诊断

常见网络连接异常及处理

常见网络连接异常及处理

本文列出了连接诊断中常见的连接异常及相应的处理措施。

公网连接诊断

异常项：MySQL 实例状态异常

处理措施：MySQL 实例状态不能为删除中、等待支付中、关停中、已关停、计费恢复中、计费回收中、已回收、已释放、销毁中、已销毁、创建失败、或错误，处于以上状态时无法连接实例。

异常项：MySQL 白名单策略异常

处理措施：确认 MySQL 白名单 IP 包含当前公网 IP。关于修改 MySQL 实例白名单的详细信息，请参见修改白名单。

私网连接诊断

异常项：MySQL 实例状态异常

处理措施：MySQL 实例状态不能为删除中、等待支付中、关停中、已关停、计费恢复中、计费回收中、已回收、已释放、销毁中、已销毁、创建失败、或错误，处于以上状态时无法连接实例。

异常项：ECS 实例状态异常

处理措施：确认 ECS 实例状态为运行中。

异常项：ECS 与 MySQL 是否处于同 VPC 异常

处理措施：确认 ECS 实例与 MySQL 实例处于同一私有网络。MySQL 实例使用的私有网络支持变更，如需调整，请参见修改实例网络配置。

异常项：ECS 安全组策略异常

处理措施：确认出方向规则允许放通 MySQL 私网地址及连接端口。如需调整，请参见管理安全组规则。

异常项：ECS 与 MySQL 网络类型是否一致异常

处理措施：确认 ECS IP 协议包含 MySQL IP 协议。

异常项：MySQL白名单策略异常

处理措施：确认 ECS 私网 IP 地址已加入 MySQL 实例的白名单。关于修改 MySQL 实例白名单的详细信息，请参见修改白名单。

caching_sha2_password 认证异常

异常项：连接 MySQL 8.0 及以上版本实例时（直连或通过数据库代理连接均可能出现），出现 caching_sha2_password 认证相关报错。例如：MySQL Connector/J 报错 Public Key Retrieval is not allowed，MySQL C API / libmysqlclient 报错 RSA public key not available，或客户端返回 Access denied for user。

处理措施：该异常发生在 caching_sha2_password 插件的全量认证阶段，多出现于用户或客户端 IP 首次连接实例、服务端尚未缓存登录凭证时。请确认满足以下任一条件后重试：

已开启 SSL 加密，并在客户端启用 TLS 传输。

客户端本地已配置 MySQL 服务端的 RSA 公钥文件。

在网络可信的场景下，允许客户端在连接时从服务端获取 RSA 公钥。

各语言客户端（MySQL Connector/J、MySQL Connector/NET、MySqlConnector for .NET、MySQL C API / libmysqlclient）的具体参数配置，请参见使用 caching_sha2_password 认证连接实例。

最近更新时间：2026.11.05 18:13:35

这个页面对您有帮助吗？

有用

有用

无用

无用