// 错误参考
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,并为高风险语句提供护栏。