PDF (US Ltr) - 6.3Mb
PDF (A4) - 6.4Mb
客户端错误消息来自 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”（%d）连接到本地 MySQL 服务器
-
错误号：
2003；符号：CR_CONN_HOST_ERROR；消息：无法连接到“%s:%u”（%d）上的 MySQL 服务器
-
错误号：
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