// 错误参考

MySQL 错误代码

用户最常遇到的 MySQL 服务器和客户端错误,每条都附有 MySQL 错误参考中的消息文本、符号和 SQLSTATE,还有错误的含义和修复方法。

解读 MySQL 错误

MySQL 报告错误时的格式是 ERROR 1062 (23000): Duplicate entry '7' for key 'users.PRIMARY'。数字是 MySQL 错误代码,方括号里的五个字符是 SQLSTATE,其余部分就是填好占位符的消息文本。

1000 到 1999 以及 3000 以上的代码由服务器引发。2000 到 2999 的代码由客户端库引发,通常是因为连接无法建立或已断开,所以服务器可能根本没有接收到该语句。

运行 SHOW WARNINGS; 之后即可查看警告和注释,它们使用相同的编号。许多数据错误,比如 1265 或 1366,在非严格 SQL 模式下是警告,在严格模式下则是错误。

本参考中的所有 MySQL 错误

79 个代码,其中 79 个有完整说明(附链接)。代码和消息来自 MySQL 8.4 错误信息参考.

连接和客户端

代码含义
2002 无法通过套接字连接 CR_CONNECTION_ERROR 无法通过套接字 '%s' 连接到本地 MySQL 服务器 (%d)
2003 无法连接到主机上的 MySQL 服务器 CR_CONN_HOST_ERROR 无法连接到 '%s:%u' 上的 MySQL 服务器 (%d)
2005 未知 MySQL 服务器主机 CR_UNKNOWN_HOST 未知 MySQL 服务器主机 '%s' (%d)
2006 MySQL 服务器已断开连接 CR_SERVER_GONE_ERROR MySQL 服务器已断开连接
2013 查询过程中与 MySQL 服务器的连接丢失 CR_SERVER_LOST 查询过程中与 MySQL 服务器的连接丢失
2055 在阶段与 MySQL 服务器的连接丢失 CR_SERVER_LOST_EXTENDED 在 '%s' 与 MySQL 服务器的连接丢失,系统错误:%d
2026 SSL 连接错误 CR_SSL_CONNECTION_ERROR SSL 连接错误:%s
2059 无法加载身份验证插件 CR_AUTH_PLUGIN_CANNOT_LOAD 无法加载身份验证插件 '%s':%s
2061 身份验证插件报告错误 CR_AUTH_PLUGIN_ERR 身份验证插件 '%s' 报告错误:%s
1251 客户端不支持认证协议 ER_NOT_SUPPORTED_AUTH_MODE 客户端不支持服务器请求的身份验证协议;考虑升级 MySQL 客户端
3159 禁止不安全的传输 ER_SECURE_TRANSPORT_REQUIRED --require_secure_transport=ON 时禁止使用不安全传输的连接。
1158 读取通信数据包时出错 ER_NET_READ_ERROR 读取通信数据包时出错
1159 读取通信数据包超时 ER_NET_READ_INTERRUPTED 读取通信数据包超时
4031 因不活动被服务器断开连接 ER_CLIENT_INTERACTION_TIMEOUT 客户端因空闲过久被服务器断开。要调整这一行为,请参见 wait_timeout 和 interactive_timeout。

访问和权限

代码含义
1045 用户访问被拒绝 ER_ACCESS_DENIED_ERROR 用户 '%s'@'%s' 访问被拒绝(使用密码: %s)
1044 用户对数据库的访问被拒绝 ER_DBACCESS_DENIED_ERROR 用户 '%s'@'%s' 对数据库 '%s' 的访问被拒绝
1130 不允许该主机连接 ER_HOST_NOT_PRIVILEGED 主机 '%s' 不允许连接到此 MySQL 服务器
1698 用户访问被拒绝(无密码) ER_ACCESS_DENIED_NO_PASSWORD_ERROR 用户 '%s'@'%s' 访问被拒绝
1142 用户对表的命令被拒绝 ER_TABLEACCESS_DENIED_ERROR 拒绝用户 '%s'@'%s' 对表 '%s' 执行 %s 命令
1143 用户对列的命令被拒绝 ER_COLUMNACCESS_DENIED_ERROR 拒绝用户 '%s'@'%s' 对表 '%s' 中列 '%s' 执行 %s 命令
1227 拒绝访问;你需要一项权限 ER_SPECIFIC_ACCESS_DENIED_ERROR 拒绝访问;执行此操作需要(至少一项)%s 权限
1396 CREATE USER 操作失败 ER_CANNOT_USER 操作 %s 对 %s 失败
1419 启用二进制日志时需要 SUPER 权限 ER_BINLOG_CREATE_ROUTINE_NEED_SUPER 你没有 SUPER 权限,且已启用二进制日志(你*可能*想使用安全性较低的 log_bin_trust_function_creators 变量)
1449 定义者用户不存在 ER_NO_SUCH_USER 指定为定义者的用户('%s'@'%s')不存在

语法和语句

代码含义
1064 你的 SQL 语法有错误 ER_PARSE_ERROR %s 在第 %d 行的 '%s' 附近
1149 SQL 语法错误 ER_SYNTAX_ERROR 你的 SQL 语法有错误;请查阅与你的 MySQL 服务器版本对应的手册,使用正确的语法
1052 列不明确 ER_NON_UNIQ_ERROR %s 中的列 '%s' 不明确
1055 表达式不在 GROUP BY 中 ER_WRONG_FIELD_WITH_GROUP '%s' 不在 GROUP BY 中
1093 无法为更新指定目标表 ER_UPDATE_TABLE_USED 在 FROM 子句中不能为更新指定目标表 '%s'
1136 列数与值数不匹配 ER_WRONG_VALUE_COUNT_ON_ROW 第 %ld 行的列数与值数不匹配
1242 子查询返回多于 1 行 ER_SUBQUERY_NO_1_ROW 子查询返回多于 1 行
1248 每个派生表必须有自己的别名 ER_DERIVED_MUST_HAVE_ALIAS 每个派生表必须有自己的别名
1318 参数数量不正确 ER_SP_WRONG_NO_OF_ARGS %s %s 的参数数量不正确;预期 %u,得到 %u

数据库、表和列

代码含义
1049 未知数据库 ER_BAD_DB_ERROR 未知数据库 '%s'
1046 未选择数据库 ER_NO_DB_ERROR 未选择数据库
1054 字段列表中有未知列 ER_BAD_FIELD_ERROR '%s' 中的未知列 '%s'
1146 表不存在 ER_NO_SUCH_TABLE 表 '%s.%s' 不存在
1050 表已存在 ER_TABLE_EXISTS_ERROR 表 '%s' 已存在
1051 未知表 ER_BAD_TABLE_ERROR 未知表 '%s'
1060 重复的列名 ER_DUP_FIELDNAME 重复的列名 '%s'
1091 无法 DROP;请检查该列/键是否存在 ER_CANT_DROP_FIELD_OR_KEY 无法 DROP '%s';请检查该列/键是否存在
1305 函数或存储过程不存在 ER_SP_DOES_NOT_EXIST %s %s 不存在
1442 触发器不能更新自己所在的表 ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG 无法在存储函数/触发器中更新表 '%s',因为它已被调用该存储函数/触发器的语句使用。

键和约束

代码含义
1062 键存在重复条目 ER_DUP_ENTRY 键 %d 的条目 '%s' 重复
1061 键名重复 ER_DUP_KEYNAME 键名 '%s' 重复
1452 外键约束失败:无法添加子行 ER_NO_REFERENCED_ROW_2 无法添加或更新子行:外键约束失败%s
1451 外键约束失败:无法删除父行 ER_ROW_IS_REFERENCED_2 无法删除或更新父行:外键约束失败%s
1216 无法添加或更新子行 ER_NO_REFERENCED_ROW 无法添加或更新子行:外键约束失败
1217 无法删除或更新父行 ER_ROW_IS_REFERENCED 无法删除或更新父行:外键约束失败
1215 无法添加外键约束 ER_CANNOT_ADD_FOREIGN 无法添加外键约束
3780 外键列不兼容 ER_FK_INCOMPATIBLE_COLUMNS 在外键约束 '%s' 中,引用列 '%s' 和被引用列 '%s' 不兼容。
1822 外键约束缺少索引 ER_FK_NO_INDEX_PARENT 添加外键约束失败。被引用表 '%s' 中缺少约束 '%s' 所需的索引
1824 无法打开被引用的表 ER_FK_CANNOT_OPEN_PARENT 无法打开被引用的表 '%s'
1048 列不能为空 ER_BAD_NULL_ERROR 列 '%s' 不能为空
3819 违反了 CHECK 约束 ER_CHECK_CONSTRAINT_VIOLATED 违反了 CHECK 约束 '%s'。
1071 指定的键太长 ER_TOO_LONG_KEY 指定的键太长;最大键长度为 %d 字节
1075 只能有一个自增列,且它必须是键 ER_WRONG_AUTO_KEY 表定义不正确;只能有一个自增列,并且它必须被定义为键
1701 无法截断有外键的表 ER_TRUNCATE_ILLEGAL_FK 无法截断被外键约束引用的表(%s)
1586 键存在重复条目(含键名) ER_DUP_ENTRY_WITH_KEY_NAME 键 '%s' 的条目 '%s' 重复
1826 重复的外键约束名称 ER_FK_DUP_NAME 重复的外键约束名称 '%s'

数据值

代码含义
1364 字段没有默认值 ER_NO_DEFAULT_FOR_FIELD 字段 '%s' 没有默认值
1366 列的值不正确 ER_TRUNCATED_WRONG_VALUE_FOR_FIELD 不正确的 %s 值:'%s'(列 '%s',第 %ld 行)
1406 列的数据太长 ER_DATA_TOO_LONG 第 %ld 行的列 '%s' 数据太长
1292 截断了不正确的值 ER_TRUNCATED_WRONG_VALUE 截断了不正确的 %s 值: '%s'
1264 列的值超出范围 ER_WARN_DATA_OUT_OF_RANGE 第 %ld 行的列 '%s' 值超出范围
1265 列的数据被截断 WARN_DATA_TRUNCATED 第 %ld 行的列 '%s' 数据被截断
1067 无效的默认值 ER_INVALID_DEFAULT '%s' 的默认值无效

事务与锁定

代码含义
1205 锁等待超时 ER_LOCK_WAIT_TIMEOUT 锁等待超时;请尝试重启事务
1213 尝试获取锁时检测到死锁 ER_LOCK_DEADLOCK 尝试获取锁时发现死锁;请尝试重新启动事务
3572 无法使用 NOWAIT 获取锁 ER_LOCK_NOWAIT 由于无法立即获取锁并且设置了 NOWAIT,语句已中止。
1206 锁数量超出锁表大小 ER_LOCK_TABLE_FULL 锁的总数超出了锁表大小
1792 在 READ ONLY 事务中写入 ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION 无法在只读事务中执行语句。
3024 已超过语句的最大执行时间 ER_QUERY_TIMEOUT 查询执行已中断,超过了语句最大执行时间

服务器限制和设置

代码含义
1040 连接过多 ER_CON_COUNT_ERROR 连接过多
1203 用户的连接数超过了 max_user_connections ER_TOO_MANY_USER_CONNECTIONS 用户 %s 的活动连接数已经超过 'max_user_connections'
1153 接收到的数据包大于 max_allowed_packet ER_NET_PACKET_TOO_LARGE 接收到的数据包大于 'max_allowed_packet' 字节
1175 安全更新模式阻止了该语句 ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE 你正在使用安全更新模式,却尝试更新一个 WHERE 条件未使用 KEY 列的表。%s
1290 服务器选项阻止了此语句 ER_OPTION_PREVENTS_STATEMENT MySQL 服务器正在以 %s 选项运行,因此无法执行此语句
1114 表已满 ER_RECORD_FILE_FULL 表 '%s' 已满
// 一个客户端,覆盖所有引擎

更快地使用 MySQL

SQLly 是 macOS、Windows 和 Linux 的原生 SQL 客户端,具备模式感知的 IntelliSense,并为高风险语句提供护栏。