数据库代理错误码说明

下载

聚焦模式

字号

最后更新时间： 2026-10-09 11:40:45

本文档已由 AI 辅助审校

通过数据库代理地址访问云数据库 MySQL 时，部分请求会在 Proxy 层完成鉴权、路由、连接管理或读写分离处理。若处理失败，Proxy 会向客户端返回对应错误码和消息文本；部分错误则由后端 MySQL 产生并经由 Proxy 原样透传。为便于业务侧识别、告警和容错，本文为您说明数据库代理相关错误码。
说明：
错误码1999是 Proxy 内部错误的统一错误码（PROXY_ERROR_CODE），具体原因需结合返回的消息文本判断。
业务侧如果之前未识别1999，在遇到只读实例被剔除、路由失败等场景时会收到该错误，建议对1999做单独错误处理或重试，避免被当作未知异常导致业务受损。
除下表列出的 Proxy 自身错误码外，其他任意错误码一般为后端 MySQL 返回的 ERR 包，由 Proxy 原样转发（例如 1044/1062/1205/1213 等标准 MySQL 错误），不是数据库代理产生。
错误码总览
错误码
SQL State
产生层
含义
1999
HY000
Proxy 自身
数据库代理内部错误的统一错误码（PROXY_ERROR_CODE），具体原因看消息文本。
1040
HY000
Proxy 自身
数据库代理侧连接数达到上限（Too many connections）。
1045
28000 / 08S01
Proxy 自身
鉴权失败类（账号密码错误、SSL 要求、握手异常等）。
1049
42000
Proxy 自身
建连时指定的目标库不存在（Unknown database '%s'）。
其他任意错误码
-
后端透传
后端 MySQL 返回的 ERR 包由 Proxy 原样转发（如1044/1062/1205/1213等标准 MySQL 错误），不是数据库代理产生。
错误码1999（Proxy 内部错误）消息明细
以下消息均以 ERROR 1999 (HY000): ... 形式返回客户端。
消息文本
触发场景
Proxy cannot find valid backend server.
路由失败找不到可用后端（最常见：主库或目标 RO 不可用/未就绪）、Hint 路由失败、重试存储查询失败。
Proxy cannot find valid backend server, reroute to ro failed.
多主/HTAP 场景重路由到只读后端失败。
Proxy cannot find valid backend server, reroute failed.
多主场景查询重路由失败。
Proxy cannot find valid backend server for query rerouting. Both AP and TP backends may be unavailable.
AP/TP 后端均不可用。
Backend server returned unexpected response, please check backend status.
后端返回非预期响应。
Backend connection not found.
竞态条件下后端连接丢失。
Write backend failed, please check backend db condition.
事务迁移阶段写后端失败。
Proxy can't write backend connection.
后端连接状态不一致导致写缓冲失败。
Proxy cannot keep connection.
会话切换缓冲异常，连接保持失败。
Proxy cannot recover transaction.
防闪断事务重放写入失败。
Proxy internal error, please contact administrator for detail.
客户端连接注册 epoll 失败（数据库代理内部异常）。
Can't find target instance.
数据库代理命令指定了未知的实例目标。
Alter database failed, can't find target instance.
切换数据库时找不到目标实例。
Alter database failed, need one database name.
切换数据库命令缺少库名。
Invalid insert target.
insertstream 过滤器目标非法。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

错误码	SQL State	产生层	含义
1999	HY000	Proxy 自身	数据库代理内部错误的统一错误码`（PROXY_ERROR_CODE）`，具体原因看消息文本。
1040	HY000	Proxy 自身	数据库代理侧连接数达到上限`（Too many connections）`。
1045	28000 / 08S01	Proxy 自身	鉴权失败类（账号密码错误、SSL 要求、握手异常等）。
1049	42000	Proxy 自身	建连时指定的目标库不存在`（Unknown database '%s'）`。
其他任意错误码	-	后端透传	后端 MySQL 返回的 ERR 包由 Proxy 原样转发（如1044/1062/1205/1213等标准 MySQL 错误），不是数据库代理产生。

消息文本	触发场景
Proxy cannot find valid backend server.	路由失败找不到可用后端（最常见：主库或目标 RO 不可用/未就绪）、Hint 路由失败、重试存储查询失败。
Proxy cannot find valid backend server, reroute to ro failed.	多主/HTAP 场景重路由到只读后端失败。
Proxy cannot find valid backend server, reroute failed.	多主场景查询重路由失败。
Proxy cannot find valid backend server for query rerouting. Both AP and TP backends may be unavailable.	AP/TP 后端均不可用。
Backend server returned unexpected response, please check backend status.	后端返回非预期响应。
Backend connection not found.	竞态条件下后端连接丢失。
Write backend failed, please check backend db condition.	事务迁移阶段写后端失败。
Proxy can't write backend connection.	后端连接状态不一致导致写缓冲失败。
Proxy cannot keep connection.	会话切换缓冲异常，连接保持失败。
Proxy cannot recover transaction.	防闪断事务重放写入失败。
Proxy internal error, please contact administrator for detail.	客户端连接注册 epoll 失败（数据库代理内部异常）。
Can't find target instance.	数据库代理命令指定了未知的实例目标。
Alter database failed, can't find target instance.	切换数据库时找不到目标实例。
Alter database failed, need one database name.	切换数据库命令缺少库名。
Invalid insert target.	insertstream 过滤器目标非法。

tencent cloud

云数据库 MySQL

数据库代理错误码说明

错误码总览

错误码1999（Proxy 内部错误）消息明细

帮助和支持