3. MySQL 数据库的基本操作 3.11. 看懂 SQL 错误代码，提高学习效率！

MySQL 出错时反馈的代码代表出错的原因，我们只有明白这些代码代表的意思，才能了解 MySQL 数据库的错误，找出原因，解决问题。下面介绍 MySQL 服务器和客户端中的错误代码、提示消息的生成方式和查看方法，最后还对 MySQL 中常见的错误代码做了详细说明。

MySQL 服务器端错误代码和消息

MySQL 是根据安装目录下 share 中的 errmsg.txt 文件来生成 include 下 mysqld_error.h 和 mysqld_ername.h 中的错误定义的。另外，SQLSTATE 的值也是根据 share 下 errmsg.txt 文件中的内容来生成 include 下的 sql_state.h 的。

默认情况下，服务器出错代码都是以 1 开头的，例如“1004 SQLSTATE: HY000 (ER_CANT_CREATE_FILE)”，该消息的错误代码为 1004，表示“无法创建文件”。

errmsg.txt 文件的部分内容如下：

#define ER_NO_SUCH_TABLE 1146
"Table '%-.64s.%-.64s' doesn't exist",
#define ER_NONEXISTING_TABLE_GRANT 1147
"There is no such grant defined for user '%-.32s' on host '%-.64s' on table '%-.64s'",
#define ER_NOT_ALLOWED_COMMAND 1148
"The used command is not allowed with this MySQL version",
#define ER_SYNTAX_ERROR 1149
"You have an error in your SQL syntax. Check the manual that corresponds to your MySQL server version for the right syntax to use",
#define ER_DELAYED_CANT_CHANGE_LOCK 1150
"Delayed insert thread couldn't get requested lock for table %-.64s",
#define ER_TOO_MANY_DELAYED_THREADS 1151
"Too many delayed threads in use",

文件中包含的 %d 和 %ld 代表数值，%s 代表字符串。显示具体信息时，它们将被消息值取代。

例如，错误代码为 1146 的错误信息在 share 下的 errmsg.txt 中显示为“Table '%-.192s.%-.192s' doesn't exist"，即“表' '%-.192s.%-.192s"不存在”。其中“%-.192s”可表示左对齐 192 个字符宽度，可理解为此处输出为占位字符串，在显示具体信息时回避字符串消息替换。

例 1

切换 test 数据库，查询数据库下有哪些数据表，SQL 语句和执行过程如下：

mysql> USE test;
Database changed
mysql> SHOW tables;
+-------------------+
| Tables_in_test    |
+-------------------+
| tb_eventtest      |
| tb_student        |
| tb_student2       |
| tb_student3       |
| tb_student_course |
| tb_students_info  |
+-------------------+
6 rows in set (0.01 sec)

查询数据表 tb_student 中的记录，SQL 语句和执行过程如下：

mysql> SELECT * FROM tb_student;
+----+--------+
| id | name   |
+----+--------+
|  1 | Java   |
|  2 | MySQL  |
|  3 | Python |
+----+--------+
3 rows in set (0.06 sec)

查询数据表 tb_oldstudent 中的记录，SQL 语句和运行结果如下：

mysql> SELECT * FROM tb_oldstudent;
ERROR 1146 (42S02): Table 'test.tb_oldstudent' doesn't exist

由结果可以看出，在 test 数据库中不存在 tb_oldstudent 数据库，服务器错误代码为 1146。

MySQL 客户端错误代码和消息

MySQL 是根据安装目录下 include 中的 errmsg.h 文件来生成错误代码的。

errmsg.h 文件的部分内容如下：

#define CR_NAMEDPIPESETSTATE_ERROR 2018
#define CR_CANT_READ_CHARSET 2019
#define CR_NET_PACKET_TOO_LARGE 2020
#define CR_EMBEDDED_CONNECTION_2021
#define CR_PROBE_SLAVE_STATUS 2022
#define CR_PROBE_SLAVE_HOSTS 2023
#define CR_PROBE_SLAVE_CONNECT 2024
#define CR_PROBE_MASTER_CONNECT 2025
#define CR_SSL_CONNECTION_ERROR 2026
#define CR_MALFORMED_PACKET 2027
#define CR_WRONG_LICENSE 2028

文件中 %d 和 %s 分别代表数值和字符串，和服务器端错误代码显示方式一样，在显示时它们将被消息值取代。

默认情况下，客户端出错代码都是以 2 开头的，例如错误代码为 2025（CR_PROBE_MASTER_CONNECT）的，表示连接到主服务器时出错。

常见错误代码

常见的服务器错误代码及说明如下表所示：


常见的客户端错误代码及说明如下所示：