MySQL是最常用的关系型数据库之一，在使用过程中也会遇到很多报错，本文列举了一些常见的错误及解决方法。

1.Can't connect to MySQL server

原因：

• MySQL 服务未启动。
• 客户端的 IP 未被允许连接（防火墙或 MySQL 的 bind-address 限制）。
• 端口号配置错误，默认是 3306。
• 服务器主机名解析失败。

解决办法：

• 检查 MySQL 服务状态：service mysql status 或 systemctl status mysql。
• 确保 MySQL 配置文件中的 bind-address 允许客户端的 IP 访问（0.0.0.0 表示允许所有 IP）。
• 检查端口是否被占用：netstat -tuln | grep 3306。
• 检查主机名解析：尝试使用 IP 连接替代域名。

2.Access denied for user 'user'@'host'

原因：

• 用户名或密码错误。
• 连接的主机不在用户权限范围内。
• 数据库权限设置有误，未正确授权。

解决办法：

• 确保用户名和密码正确。
• 在 MySQL 中检查用户权限：

SELECT host, user FROM mysql.user;

• 更新用户权限：

GRANT ALL PRIVILEGES ON *.* TO 'user'@'host' IDENTIFIED BY 'password'; FLUSH PRIVILEGES;

3.Too many connections

原因：

• 达到了 MySQL 的最大连接数限制（max_connections 参数）。

解决办法：

• 增加 MySQL 的 max_connections 值：

SET GLOBAL max_connections = 500;

• 检查并终止闲置连接：

SHOW PROCESSLIST; 
KILL <id>;

• 优化应用程序的连接池管理。

4.Unknown database 'database_name'

原因：

• 数据库不存在。
• 数据库名称拼写错误。

解决办法：

• 确认数据库是否存在：

SHOW DATABASES;

• 如果不存在，创建数据库：

CREATE DATABASE database_name;

5.MySQL server has gone away

原因：

• 查询超时，超过 wait_timeout 或 max_allowed_packet 限制。
• 服务器突然崩溃或断开。

解决办法：

• 检查并增大 max_allowed_packet 参数：

SET GLOBAL max_allowed_packet = 16M;

• 增大 wait_timeout 的值：

SET GLOBAL wait_timeout = 28800;

6.SSL connection error

原因：

• SSL 配置不正确或证书不匹配。

解决办法：

• 检查 MySQL 配置文件的 SSL 参数是否正确。
• 确保证书有效并匹配服务器配置。

7.Lost connection to MySQL server during query

原因：

• 网络连接中断。
• 查询太复杂，导致超时。

解决办法：

• 优化网络环境，降低延迟。
• 优化查询性能，分解复杂查询。

如果需要进一步排查，建议：

1. 查看 MySQL 的错误日志（通常位于 /var/log/mysql/error.log）。
2. 确保客户端和服务器的版本兼容性。

8.Error establishing a database connection

原因：

• 数据库配置文件中用户名、密码、主机或端口错误。
• 数据库服务未启动或网络中断。

解决办法：

• 确认配置文件中连接参数正确。
• 检查 MySQL 服务状态并重启服务。
• 检查网络连接，特别是主机防火墙规则。

9.Packet for query is too large

原因：

• 查询数据包大小超过 max_allowed_packet 限制。

解决办法：

• 增大 max_allowed_packet 参数：

SET GLOBAL max_allowed_packet = 64M;

• 确保客户端和服务器的配置一致。

10.The server does not support SSL connections

原因：

• 客户端尝试通过 SSL 连接，而服务器未启用 SSL。
• SSL 配置错误或未安装相关证书。

解决办法：

• 确保 MySQL 配置启用了 SSL：

[mysqld]
ssl-ca=/path/to/ca-cert.pem ssl-cert=/path/to/server-cert.pem ssl-key=/path/to/server-key.pem

• 如果不需要 SSL，可以禁用客户端的 SSL 选项。

11.Host 'x.x.x.x' is not allowed to connect to this MySQL server

原因：

• 客户端的 IP 地址未被授权。
• 用户权限设置中限制了访问的主机。

解决办法：

• 确保用户权限允许该主机访问：

GRANT ALL PRIVILEGES ON *.* TO 'user'@'x.x.x.x' IDENTIFIED BY 'password'; FLUSH PRIVILEGES;

• 检查 MySQL 配置中的 bind-address 参数是否允许远程连接。

12.Connection refused

原因：

• MySQL 服务未启动或监听端口被占用。
• 网络防火墙规则限制了访问。

解决办法：

• 确保 MySQL 正在监听正确的端口：

netstat -tuln | grep 3306

• 检查防火墙或安全组规则，允许访问 3306 端口。

13.Reading from the stream has failed 或 Reading from the connection stream

原因：

• 网络中断或超时。
• 查询数据包过大，导致连接断开。

解决办法：

• 优化网络连接，避免高延迟。
• 增大 net_read_timeout 和 net_write_timeout 参数。

14.Error 1045: 28000 (Authentication error)

原因：

• 密码错误或用户未被授权访问目标数据库。

解决办法：

• 使用正确的用户名和密码登录。
• 检查用户权限是否允许访问：

SHOW GRANTS FOR 'user'@'host';

• 重置用户密码：

ALTER USER 'user'@'host' IDENTIFIED BY 'new_password';

15.Out of memory

原因：

• 查询需要的内存超出了服务器的物理限制。
• 查询过于复杂或数据量过大。

解决办法：

• 优化查询和索引以减少内存占用。
• 增加服务器的内存，调整 MySQL 的缓冲参数（如 innodb_buffer_pool_size）。

16.Table 'x' doesn't exist

原因：

• 查询的表不存在或拼写错误。
• 表所在的数据库未选择。

解决办法：

• 确认表名和数据库拼写正确。
• 确保连接到正确的数据库。

17.Foreign key constraint fails

原因：

• 插入或更新的外键值在目标表中不存在。
• 外键约束规则未满足。

解决办法：

• 确保目标表中存在对应的外键值。
• 检查数据是否符合外键约束规则。

18.Lock wait timeout exceeded

原因：

• 查询被其他事务长时间锁定。
• 锁竞争严重。

解决办法：

• 增加 innodb_lock_wait_timeout 参数值：

SET GLOBAL innodb_lock_wait_timeout = 50;

• 检查长时间运行的事务并终止：

SHOW PROCESSLIST;
KILL <id>;

19.Plugin 'caching_sha2_password' could not be loaded

原因：

• MySQL 客户端或驱动程序版本过低，不支持 caching_sha2_password 身份验证插件。

解决办法：

• 升级 MySQL 客户端或驱动程序。
• 更改用户的身份验证插件：

ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'password';

20.Incorrect datetime value

原因：

• 插入的日期时间格式不正确。

解决办法：

• 使用正确的日期格式（YYYY-MM-DD HH:MM:SS）。
• 确保时区设置一致。

如果仍然无法解决，建议使用 SHOW WARNINGS 查看更多上下文信息，并查阅 MySQL 错误日志以获得更详细的线索。

21.Table is full

原因：

• 表达到文件系统或存储引擎的最大大小限制。
• 磁盘空间不足。

解决办法：

• 确保磁盘有足够的可用空间。
• 如果使用 MyISAM 或 InnoDB，检查存储引擎的文件大小限制。

22.Error Code: 1054 - Unknown column

原因：

• 查询中使用了不存在的列名。
• 表结构发生变化，列名被删除或修改。

解决办法：

• 检查表结构并确认列名：

SHOW COLUMNS FROM table_name;

23.Error Code: 1215 - Cannot add foreign key constraint

原因：

• 外键列的类型或字符集不匹配。
• 目标表不存在。

解决办法：

• 确认外键和目标列的数据类型和字符集完全一致。
• 确保目标表和列存在。

24.Error Code: 1062 - Duplicate entry

原因：

• 插入的值在唯一索引或主键中重复。

解决办法：

• 确保插入的数据唯一。
• 使用 ON DUPLICATE KEY UPDATE 语句避免冲突。

25.Error Code: 1146 - Table doesn’t exist

原因：

• 查询的表不存在或被删除。
• 数据库未正确选择。

解决办法：

• 确认表名和数据库是否正确。
• 使用完整表名：database_name.table_name。

26.Error Code: 1292 - Truncated incorrect date value

原因：

• 插入的数据不是有效的日期时间格式。

解决办法：

• 使用标准日期格式（YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS）。

27.Error Code: 1452 - Cannot add or update a child row

原因：

• 插入或更新的外键值在父表中不存在。

解决办法：

• 确保目标表中存在相应的外键值。

28.Error Code: 1449 - The user specified as a definer does not exist

原因：

• 存储过程、触发器或视图的创建者用户已被删除。

解决办法：

• 更新 DEFINER 为有效的用户：

ALTER DEFINER=`new_user`@`host` PROCEDURE procedure_name ...

29.Error Code: 1118 - Row size too large

原因：

• 表中列总大小超过 InnoDB 行大小限制（默认 8126 字节）。

解决办法：

• 调整列的类型，避免使用过多的 TEXT 或 BLOB。

30.Error Code: 2013 - Lost connection to MySQL server

原因：

• 查询超时或网络问题。

解决办法：

• 增加客户端超时时间，例如 mysql.connect_timeout。

31.Error Code: 1022 - Can't write; duplicate key in table

原因：

• 插入的键值违反唯一约束。

解决办法：

• 修改插入值以满足唯一约束。

32.Error Code: 1130 - Host not allowed to connect

原因：

• 客户端 IP 未被授权连接。

解决办法：

• 修改 MySQL 配置并添加客户端 IP 的授权。

33.Error Code: 1347 - View’s SELECT contains a subquery in the FROM clause

原因：

• 视图中包含不支持的子查询。

解决办法：

• 将子查询提取到单独的视图中。

34.Error Code: 1030 - Got error 28 from storage engine

原因：

• 磁盘空间不足。

解决办法：

• 释放磁盘空间或更换到更大的存储设备。

35.Error Code: 1093 - You can't specify target table for update in FROM clause

原因：

• 在 UPDATE 或 DELETE 查询中，目标表出现在 FROM 子句中。

解决办法：

• 使用派生表解决：

UPDATE table_name SET column = value WHERE id IN (SELECT id FROM (SELECT id FROM table_name) AS temp_table);

36.Error Code: 1166 - Incorrect column name

原因：

• 列名使用了保留关键字或非法字符。

解决办法：

• 使用反引号（`）括起来列名。

37.Error Code: 1049 - Unknown database

原因：

• 数据库不存在。

解决办法：

• 确认数据库名称拼写正确或创建数据库。

38.Error Code: 1878 - Temporary file write failure

原因：

• 临时目录没有足够的权限或空间。

解决办法：

• 检查 MySQL 配置文件中的 tmpdir 设置并确保可写。

39.Error Code: 126 - Incorrect key file for table

原因：

• 表的索引文件损坏。

解决办法：

• 修复表：

REPAIR TABLE table_name;

40.Error Code: 1064 - Syntax error

原因：

• 查询语法不正确。

解决办法：

• 检查语法是否符合 MySQL 标准。

41.Error Code: 1216 - Cannot add or update a child row

原因：

• 外键值不满足约束。

解决办法：

• 检查相关表的数据一致性。

42.Error Code: 1205 - Lock wait timeout exceeded

原因：

• 事务竞争导致锁超时。

解决办法：

• 检查并优化事务管理。

43.Error Code: 1050 - Table already exists

原因：

• 创建的表已存在。

解决办法：

• 检查表是否存在，必要时删除旧表。

44.Error Code: 1558 - Failed to open the relay log

原因：

• 主从复制中继日志损坏。

解决办法：

• 重启从服务器并重新同步。

45.Error Code: 1411 - Incorrect datetime value

原因：

• 日期值格式不符合要求。

解决办法：

• 修正日期格式。

46.Error Code: 1044 - Access denied for user to database

原因：

• 用户没有目标数据库的权限。

解决办法：

• 授予用户适当权限。

47.Error Code: 1047 - Unknown command

原因：

• 客户端与服务器版本不兼容。

解决办法：

• 升级客户端版本。

48.Error Code: 1194 - Table is marked as crashed

原因：

• 表损坏。

解决办法：

• 修复表：

REPAIR TABLE table_name;

49.Error Code: 1364 - Field doesn't have a default value

原因：

• 插入时未为非空字段提供值。

解决办法：

• 指定字段默认值或提供有效值。

50.Error Code: 1048 - Column cannot be null

原因：

• 非空列插入了 NULL 值。

解决办法：

• 为非空列提供有效值。