Cpanel自动更新后MySQL 8.0.25无法启动故障排查求助

问题根源 #

本次故障是cpanel自动将MySQL从8.0.24升级到8.0.25的过程中，服务器意外断网、强制断电重启，导致mysql系统库的general_log表损坏，同时user系统表存在NULL值不符合新版本的字段约束，最终升级流程中断，MySQL服务无法启动。你观察到的ALTER语句多余空格不是问题诱因，SQL语法允许多个连续空格。

修复步骤 #

1. 先行备份数据

操作前先完整备份现有MySQL数据目录，避免操作失误导致数据丢失：

cp -rp /var/lib/mysql /var/lib/mysql_bak_$(date +%Y%m%d)

2. 临时启动MySQL（跳过权限校验和升级逻辑）

执行以下命令启动临时MySQL进程，不加载权限表、不监听外部网络，跳过强制升级逻辑：

mysqld_safe --skip-grant-tables --skip-networking --upgrade=MINIMAL &

等待10秒左右确认进程启动。

3. 修复损坏的系统表

直接执行mysql命令即可登录无需密码，依次执行以下SQL语句：

-- 切换到mysql系统库
USE mysql;

-- 重建损坏的general_log表（CSV引擎无需保留原有数据）
DROP TABLE IF EXISTS general_log;
CREATE TABLE general_log (
  event_time TIMESTAMP(6) NOT NULL DEFAULT CURRENT_TIMESTAMP(6) ON UPDATE CURRENT_TIMESTAMP(6),
  user_host MEDIUMTEXT NOT NULL,
  thread_id BIGINT UNSIGNED NOT NULL,
  server_id INTEGER UNSIGNED NOT NULL,
  command_type VARCHAR(64) NOT NULL,
  argument MEDIUMBLOB NOT NULL
) ENGINE=CSV DEFAULT CHARSET=utf8 COMMENT='General log';

-- 修复user表的NULL值，满足新版本NOT NULL约束
UPDATE mysql.user SET max_updates = 0 WHERE max_updates IS NULL;
UPDATE mysql.user SET max_connections = 0 WHERE max_connections IS NULL;
UPDATE mysql.user SET max_user_connections = 0 WHERE max_user_connections IS NULL;
UPDATE mysql.user SET ssl_cipher = '' WHERE ssl_cipher IS NULL;
UPDATE mysql.user SET x509_issuer = '' WHERE x509_issuer IS NULL;
UPDATE mysql.user SET x509_subject = '' WHERE x509_subject IS NULL;

FLUSH PRIVILEGES;
EXIT;

4. 关闭临时MySQL进程

mysqladmin shutdown

5. 恢复配置并正常启动服务

先把/etc/my.cnf里的socket配置改回cpanel默认路径，避免后续cpanel组件无法连接数据库：

[client]
socket=/var/lib/mysql/mysql.sock

[mysqld]
socket=/var/lib/mysql/mysql.sock
# 其余原有配置保留不变

然后正常启动MySQL服务：

systemctl start mysqld

启动后可执行以下命令确认升级完成：

mysql_upgrade -u root -p

6. 验证cpanel状态

执行cpanel自带的MySQL重启脚本，确认无报错：

/usr/local/cpanel/scripts/restartsrv_mysql

内容的提问来源于stack exchange，提问作者AsessionGuy