MySQL 啟動報錯「The server quit without updating PID file」完整排查清單

錯誤訊息

MySQL server PID file could not be found!
Starting MySQL... The server quit without updating PID file (/usr/local/mysql/data/hostname.pid).

快速排查步驟（按可能性排序）

1. 磁碟空間不足 — df -h 檢查，清理日誌/備份騰出空間
2. 權限問題 — chown -R mysql:mysql /data/dir; chmod -R 755 /data/dir
3. 殘留進程 — ps -ef | grep mysqld; kill -9 PID 後重啟
4. 殘留鎖檔 — 刪除 mysql-bin.index、*.pid、*.err 後重啟
5. 配置檔缺失 datadir — [mysqld] datadir=/path/to/data
6. skip-federated 未註釋 — my.cnf 中註釋掉
7. 錯誤日誌目錄不存在/無權限 — 建立目錄並授權
8. SELinux 阻擋 — setenforce 0 或修改 /etc/selinux/config 設 SELINUX=disabled 重開機

實戰案例：磁碟滿導致啟動失敗

[root@snsgou ~]# df -h
Filesystem            Size  Used Avail Use% Mounted on
/dev/mapper/vg-root   50G   48G  1.2G  98% /   <-- 根分區滿
# 清理後重啟仍失敗，檢查錯誤日誌發現 mysql-bin.index 殘留，刪除後正常啟動

最佳實踐：標準化排查腳本

#!/bin/bash
# check_mysql_start.sh
echo "1. Disk: "; df -h /var/lib/mysql
echo "2. Process: "; ps -ef | grep [m]ysqld
echo "3. Config: "; mysqld --verbose --help 2>/dev/null | grep -A1 'Default options'
echo "4. Permissions: "; ls -ld /var/lib/mysql
echo "5. SELinux: "; getenforce
echo "6. Error log tail: "; tail -20 /var/log/mysqld.log

核心原則： 先看錯誤日誌 (tail -f /var/log/mysqld.log)，再按清單逐項排查，不可盲目重啟。