客户端错误消息源自 MySQL 客户端库内部。以下是 mysql 客户端显示的客户端错误消息示例
$> mysql -h no-such-host
ERROR 2005 (HY000): Unknown MySQL server host 'no-such-host' (0)
每个客户端错误消息都包含错误代码、SQLSTATE 值和消息字符串,如 错误消息来源和元素 中所述。这些元素的可用方式如 错误信息接口 中所述。对于客户端错误,SQLSTATE 值始终为 'HY000'
(常规错误),因此它对于区分不同的客户端错误没有意义。
客户端库还向主机客户端程序提供源自服务器端并由客户端从服务器接收的任何错误。有关服务器端错误的列表,请参阅 第 2 章,服务器错误消息参考。
除了以下列表中的错误之外,客户端库还可以生成错误代码在 1 到 999 范围内的错误消息。请参阅 第 4 章,全局错误消息参考
-
错误号:
2000
;符号:CR_UNKNOWN_ERROR
;消息:未知的 MySQL 错误
-
错误号:
2001
;符号:CR_SOCKET_CREATE_ERROR
;消息:无法创建 UNIX 套接字 (%d)
-
错误号:
2002
;符号:CR_CONNECTION_ERROR
;消息:无法通过套接字 '%s' 连接到本地 MySQL 服务器 (%d)
-
错误号:
2003
;符号:CR_CONN_HOST_ERROR
;消息:无法连接到 '%s:%u' 上的 MySQL 服务器 (%d)
-
错误号:
2004
;符号:CR_IPSOCK_ERROR
;消息:无法创建 TCP/IP 套接字 (%d)
-
错误号:
2005
;符号:CR_UNKNOWN_HOST
;消息:未知的 MySQL 服务器主机 '%s' (%d)
-
错误号:
2006
;符号:CR_SERVER_GONE_ERROR
;消息:MySQL 服务器已断开连接
-
错误号:
2007
;符号:CR_VERSION_ERROR
;消息:协议不匹配;服务器版本 = %d,客户端版本 = %d
-
错误号:
2008
;符号:CR_OUT_OF_MEMORY
;消息:MySQL 客户端内存不足
-
错误号:
2009
;符号:CR_WRONG_HOST_INFO
;消息:主机信息错误
-
错误号:
2010
;符号:CR_LOCALHOST_CONNECTION
;消息:通过 UNIX 套接字连接到本地主机
-
错误号:
2011
;符号:CR_TCP_CONNECTION
;消息:通过 TCP/IP 连接到 %s
-
错误号:
2012
;符号:CR_SERVER_HANDSHAKE_ERR
;消息:服务器握手错误
-
错误号:
2013
;符号:CR_SERVER_LOST
;消息:查询期间与 MySQL 服务器的连接断开
-
错误号:
2014
;符号:CR_COMMANDS_OUT_OF_SYNC
;消息:命令不同步;您现在无法运行此命令
命令执行顺序不正确。当调用的函数不适用于当前连接状态时,会发生此错误。例如,如果
mysql_stmt_fetch()
的调用次数不足以读取整个结果集(即,不足以返回MYSQL_NO_DATA
),则可能会对以下 C API 调用发生此错误。 -
错误号:
2015
;符号:CR_NAMEDPIPE_CONNECTION
;消息:命名管道:%s
-
错误号:
2016
;符号:CR_NAMEDPIPEWAIT_ERROR
;消息:无法等待主机上的命名管道:%s 管道:%s (%lu)
-
错误号:
2017
;符号:CR_NAMEDPIPEOPEN_ERROR
;消息:无法打开主机上的命名管道:%s 管道:%s (%lu)
-
错误号:
2018
;符号:CR_NAMEDPIPESETSTATE_ERROR
;消息:无法设置主机上的命名管道状态:%s 管道:%s (%lu)
-
错误号:
2019
;符号:CR_CANT_READ_CHARSET
;消息:无法初始化字符集 %s(路径:%s)
-
错误号:
2020
;符号:CR_NET_PACKET_TOO_LARGE
;消息:获取到的数据包大于 'max_allowed_packet' 字节
-
错误号:
2021
;符号:CR_EMBEDDED_CONNECTION
;消息:嵌入式服务器
-
错误号:
2022
;符号:CR_PROBE_REPLICA_STATUS
;消息:SHOW REPLICA STATUS 错误
-
错误号:
2023
;符号:CR_PROBE_REPLICA_HOSTS
;消息:SHOW REPLICA HOSTS 错误
-
错误号:
2024
;符号:CR_PROBE_REPLICA_CONNECT
;消息:连接到副本时出错
-
错误号:
2025
;符号:CR_PROBE_SOURCE_CONNECT
;消息:连接到源时出错
-
错误号:
2026
;符号:CR_SSL_CONNECTION_ERROR
;消息:SSL 连接错误:%s
-
错误号:
2027
;符号:CR_MALFORMED_PACKET
;消息:数据包格式错误
-
错误号:
2028
;符号:CR_WRONG_LICENSE
;消息:此客户端库仅被许可用于具有 '%s' 许可证的 MySQL 服务器
-
错误号:
2029
;符号:CR_NULL_POINTER
;消息:无效使用空指针
-
错误号:
2030
;符号:CR_NO_PREPARE_STMT
;消息:语句未预处理
-
错误号:
2031
;符号:CR_PARAMS_NOT_BOUND
;消息:预处理语句中未提供参数数据
-
错误号:
2032
;符号:CR_DATA_TRUNCATED
;消息:数据被截断
-
错误号:
2033
;符号:CR_NO_PARAMETERS_EXISTS
;消息:语句中不存在参数
-
错误号:
2034
;符号:CR_INVALID_PARAMETER_NO
;消息:无效的参数编号
mysql_stmt_fetch_column()
的列号无效。mysql_stmt_send_long_data()
的参数编号无效。键名为空或
mysql_options4()
的连接属性数据量超过 64KB 限制。 -
错误号:
2035
;符号:CR_INVALID_BUFFER_USE
;消息:无法为非字符串/非二进制数据类型发送长数据(参数:%d)
-
错误号:
2036
;符号:CR_UNSUPPORTED_PARAM_TYPE
;消息:使用了不支持的缓冲区类型:%d(参数:%d)
-
错误号:
2037
;符号:CR_SHARED_MEMORY_CONNECTION
;消息:共享内存:%s
-
错误号:
2038
;符号:CR_SHARED_MEMORY_CONNECT_REQUEST_ERROR
;消息:无法打开共享内存;客户端无法创建请求事件 (%lu)
-
错误号:
2039
;符号:CR_SHARED_MEMORY_CONNECT_ANSWER_ERROR
;消息:无法打开共享内存;未从服务器接收到应答事件 (%lu)
-
错误号:
2040
;符号:CR_SHARED_MEMORY_CONNECT_FILE_MAP_ERROR
;消息:无法打开共享内存;服务器无法分配文件映射 (%lu)
-
错误号:
2041
;符号:CR_SHARED_MEMORY_CONNECT_MAP_ERROR
;消息:无法打开共享内存;服务器无法获取文件映射的指针 (%lu)
-
错误号:
2042
;符号:CR_SHARED_MEMORY_FILE_MAP_ERROR
;消息:无法打开共享内存;客户端无法分配文件映射 (%lu)
-
错误号:
2043
;符号:CR_SHARED_MEMORY_MAP_ERROR
;消息:无法打开共享内存;客户端无法获取文件映射的指针 (%lu)
-
错误号:
2044
;符号:CR_SHARED_MEMORY_EVENT_ERROR
;消息:无法打开共享内存;客户端无法创建 %s 事件 (%lu)
-
错误号:
2045
;符号:CR_SHARED_MEMORY_CONNECT_ABANDONED_ERROR
;消息:无法打开共享内存;服务器无响应 (%lu)
-
错误号:
2046
;符号:CR_SHARED_MEMORY_CONNECT_SET_ERROR
;消息:无法打开共享内存;无法向服务器发送请求事件 (%lu)
-
错误号:
2047
;符号:CR_CONN_UNKNOW_PROTOCOL
;消息:错误或未知协议
-
错误号:
2048
;符号:CR_INVALID_CONN_HANDLE
;消息:无效的连接句柄
-
错误号:
2049
;符号:CR_UNUSED_1
;消息:使用旧(4.1.1 之前)身份验证协议的连接被拒绝(客户端选项“secure_auth”已启用)
-
错误号:
2050
;符号:CR_FETCH_CANCELED
;消息:mysql_stmt_close() 调用取消了行检索
-
错误号:
2051
;符号:CR_NO_DATA
;消息:尝试在没有事先获取行的情况下读取列
-
错误号:
2052
;符号:CR_NO_STMT_METADATA
;消息:预处理语句不包含元数据
-
错误号:
2053
;符号:CR_NO_RESULT_SET
;消息:尝试在没有与语句关联的结果集时读取行
-
错误号:
2054
;符号:CR_NOT_IMPLEMENTED
;消息:此功能尚未实现
-
错误号:
2055
;符号:CR_SERVER_LOST_EXTENDED
;消息:与 MySQL 服务器在“%s”处的连接断开,系统错误:%d
-
错误号:
2056
;符号:CR_STMT_CLOSED
;消息:由于前面的 %s() 调用,语句被间接关闭
-
错误号:
2057
;符号:CR_NEW_STMT_METADATA
;消息:结果集中的列数与绑定缓冲区的数量不同。您必须重置语句,重新绑定结果集列,然后再次执行该语句
-
错误号:
2058
;符号:CR_ALREADY_CONNECTED
;消息:此句柄已连接。每个连接使用单独的句柄。
-
错误号:
2059
;符号:CR_AUTH_PLUGIN_CANNOT_LOAD
;消息:无法加载身份验证插件“%s”:%s
-
错误号:
2060
;符号:CR_DUPLICATE_CONNECTION_ATTR
;消息:已存在同名属性
为
mysql_options4()
指定了重复的连接属性名称。 -
错误号:
2061
;符号:CR_AUTH_PLUGIN_ERR
;消息:身份验证插件“%s”报告错误:%s
-
错误号:
2062
;符号:CR_INSECURE_API_ERR
;消息:不安全的 API 函数调用:“%s” 请改用:“%s”
检测到不安全的函数调用。修改应用程序以使用建议的替代函数。
-
错误号:
2063
;符号:CR_FILE_NAME_TOO_LONG
;消息:文件名过长
-
错误号:
2064
;符号:CR_SSL_FIPS_MODE_ERR
;消息:设置 FIPS 模式 ON/STRICT 失败
-
错误号:
2065
;符号:CR_DEPRECATED_COMPRESSION_NOT_SUPPORTED
;消息:异步协议不支持压缩协议
-
错误号:
2066
;符号:CR_COMPRESSION_WRONGLY_CONFIGURED
;消息:连接失败,因为压缩算法配置错误
-
错误号:
2067
;符号:CR_KERBEROS_USER_NOT_FOUND
;消息:找不到 SSO 用户,请使用 kerberos 执行 SSO 身份验证。
-
错误号:
2068
;符号:CR_LOAD_DATA_LOCAL_INFILE_REJECTED
;消息:由于访问限制,LOAD DATA LOCAL INFILE 文件请求被拒绝。
-
错误号:
2069
;符号:CR_LOAD_DATA_LOCAL_INFILE_REALPATH_FAIL
;消息:确定“%s”的真实路径失败,错误为 (%d):%s
-
错误号:
2070
;符号:CR_DNS_SRV_LOOKUP_FAILED
;消息:DNS SRV 查询失败,错误为:%d
-
错误号:
2071
;符号:CR_MANDATORY_TRACKER_NOT_FOUND
;消息:客户端无法识别服务器标记为必需的跟踪器类型 %d。
-
错误号:
2072
;符号:CR_INVALID_FACTOR_NO
;消息:MYSQL_OPT_USER_PASSWORD 选项的第一个参数无效。有效值应介于 1 到 3 之间(含)。
-
错误号:
2073
;符号:CR_CANT_GET_SESSION_DATA
;消息:无法获取会话数据:%s
-
错误号:
2074
;符号:CR_INVALID_CLIENT_CHARSET
;消息:“%s”字符集的最小字符长度超过 1 个字节,不能用作客户端字符集。请使用任何单字节最小字符集,例如 utf8mb4、latin1 等。
-
错误号:
2075
;符号:CR_TLS_SERVER_NOT_FOUND
;消息:服务器拒绝了指定 sni 服务器名称的 ssl 握手,ssl 错误:%s