在mysql数据库的使用过程中，无论是执行SQL语句、连接数据库还是进行权限操作，都可能出现各类错误，每个错误都会对应一个唯一的错误码，通过错误码可以快速定位问题根源。掌握mysql错误码的查看与查询方法，是数据库运维和开发人员的必备技能。
一、通过命令行直接查看当前错误码
当执行某条SQL语句或者操作命令出现报错时，最直接的方式就是在当前mysql客户端会话中查看错误码。mysql客户端会在报错信息中同时返回错误码和错误描述，我们也可以通过专属命令获取更详细的错误码信息。
1.1 查看最后一次执行的错误码
使用SHOW ERRORS命令可以查看当前会话中最后一次执行产生的错误信息，包含错误码、错误级别和错误描述：
-- 执行一条会报错的SQL，比如查询不存在的表 SELECT * FROM non_exist_table; -- 查看最后一次的错误信息 SHOW ERRORS;
执行上述命令后，会返回类似如下的结果，其中Code列就是错误码：
| Level | Code | Message |
|---|---|---|
| Error | 1146 | Table 'test.non_exist_table' doesn't exist |
1.2 查看所有错误和警告
如果需要查看当前会话中所有的错误和警告信息，可以使用SHOW WARNINGS命令，该命令会返回错误、警告、注意三类信息，同样包含对应的错误码：
-- 执行可能产生警告的SQL，比如向非空约束字段插入空值 INSERT INTO test_table (id, name) VALUES (1, NULL); -- 查看所有警告和错误信息 SHOW WARNINGS;
二、查询系统表获取错误码详细说明
mysql的information_schema系统库中提供了ERRORS表，存储了当前会话中产生的错误信息，我们可以通过查询该表获取更结构化的错误码和对应描述。
2.1 查询ERRORS表获取错误码
ERRORS表的字段包含错误码、错误描述、错误发生的时间等，查询方式如下：
-- 查询当前会话的所有错误信息 SELECT ERROR_CODE, ERROR_MESSAGE FROM information_schema.ERRORS;
如果需要查询特定错误码的说明，可以添加WHERE条件过滤：
-- 查询错误码1146的说明 SELECT ERROR_CODE, ERROR_MESSAGE FROM information_schema.ERRORS WHERE ERROR_CODE = 1146;
2.2 查询全局错误码定义
mysql的错误码定义是固定的，我们也可以通过查询information_schema中的ENGINES等系统表间接获取部分通用错误码信息，不过更推荐结合官方错误码列表进行查询，若需要自定义错误码映射表，也可以自行创建表存储错误码和说明的对应关系：
-- 创建自定义错误码映射表
CREATE TABLE IF NOT EXISTS mysql_error_map (
error_code INT PRIMARY KEY,
error_desc VARCHAR(255) NOT NULL,
solution TEXT
);
-- 插入常见错误码说明
INSERT INTO mysql_error_map (error_code, error_desc, solution) VALUES
(1045, 'Access denied for user', '检查用户名密码是否正确，用户是否有对应主机访问权限'),
(1146, 'Table does not exist', '检查表名是否正确，是否选择了正确的数据库'),
(1064, 'SQL syntax error', '检查SQL语句语法是否符合mysql规范');
-- 查询错误码对应说明
SELECT error_desc, solution FROM mysql_error_map WHERE error_code = 1045;
三、查看mysql错误日志获取历史错误码
如果错误不是在当前会话产生的，比如数据库服务启动失败、后台任务报错等，就需要通过查看mysql的错误日志来获取对应的错误码。错误日志会记录mysql服务运行过程中产生的所有错误信息，包含错误发生时间、错误码和详细描述。
3.1 定位错误日志文件路径
首先可以通过以下命令查看当前mysql实例的错误日志存储路径：
-- 查看错误日志路径配置 SHOW VARIABLES LIKE 'log_error';
执行后会返回类似/var/log/mysql/error.log的路径，不同安装方式路径可能不同，比如Windows下可能在mysql安装目录的data文件夹下。
3.2 查看错误日志内容
拿到错误日志路径后，可以通过系统命令查看日志内容，日志中每行错误信息都会包含对应的错误码，比如：
# Linux系统查看错误日志最后100行 tail -n 100 /var/log/mysql/error.log
日志内容中会出现类似[ERROR] 2024-05-20T10:00:00.123456Z 1234 [MY-0001045] [Server] Access denied for user 'root'@'localhost' (using password: YES)的记录，其中0001045就是对应的错误码，去掉前导零后就是1045错误码。
四、常见mysql错误码说明
了解常见错误码的含义可以帮助我们更快排查问题，以下是一些高频出现的mysql错误码：
- 1045：访问被拒绝，通常是用户名密码错误或者用户没有对应主机的访问权限
- 1064：SQL语法错误，需要检查SQL语句的语法是否符合mysql规范
- 1146：表不存在，检查表名是否正确，是否使用了正确的数据库
- 1216/1217：外键约束错误，通常是插入、更新、删除数据时违反了外键约束规则
- 2002：无法连接到本地mysql服务器，通常是mysql服务没有启动或者socket文件路径错误
- 2003：无法连接到远程mysql服务器，检查远程主机是否可达，端口是否开放，防火墙是否拦截
五、总结
mysql错误码的查看和查询方法主要有三种：一是通过SHOW ERRORS、SHOW WARNINGS命令查看当前会话的错误码；二是通过查询information_schema.ERRORS系统表获取结构化的错误信息；三是通过查看mysql错误日志获取历史错误信息对应的错误码。日常使用中可以根据场景选择合适的方法，同时建议维护一份常用的错误码映射表，提升问题排查效率。
mysql错误码information_schemaSHOW命令错误日志修改时间：2026-07-10 14:27:14