客戶端連接 MySQL 失敗故障排除
在 MySQL 的日常運維中,客戶端連接 MySQL 失敗的現象也很常見。對于這種情況,分下面的三類進行排查。
一、mysqld 進程沒有正常運行
遇到這種情況首先到服務器上看看 mysqld 進程是否活著,采用的命令:
- mysqladmin ping
- 或
- ps -ef | grep mysqld
二、客戶端不能和進程 mysqld 通信
如果 MySQL 服務器上的 mysqld 進程運行正常,我們再看看客戶端能不能和 mysqld 進行通信,使用下面的命令進行網絡連通的測試:
- telnet localhost 3306
如果本地能通,再到客戶端的機器上把 localhost 換成 MySQL 服務器的 ip 地址進行測試。如果不能通,通常有兩種原因,一種原因是 OS 或網絡的問題,或者是防火墻;另一種原因是 mysqld 自身根本沒有偵聽客戶端的連接請求, mysqld 啟動后對于客戶端的偵聽是分三種情況。
第一種情況
是使用參數 --skip-networking 跳過偵聽客戶端的網絡連接,用下面的命令我們可以看到 MySQL 根本沒有偵聽 3306 端口。
- mysqld --no-defaults --console --user mysql --skip-networking &
- netstat -plunt|grep 3306
第二種情況
使用參數 --bind-address 后面增加對客戶端訪問 IP 地址的限制,例如只偵聽本地的連接:
- mysqld --no-defaults --user mysql --bind-address=127.0.0.1 &
- netstat -plunt|grep 3306
- tcp 0 0 127.0.0.1:3306 0.0.0.0:* LISTEN 22767/mysqld
- tcp6 0 0 :::33060 :::* LISTEN 22767/mysqld
- mysqld --no-defaults --user mysql --bind-address='192.168.17.40' &
- netstat -plunt|grep 3306
- tcp 0 0 192.168.17.40:3306 0.0.0.0:* LISTEN 23053/mysqld
- tcp6 0 0 :::33060 :::* LISTEN 23053/mysqld
第三種情況
對客戶端訪問 IP 地址的不進行限制。
- mysqld --no-defaults --user mysql &
- netstat -plunt|grep 3306
- tcp6 0 0 :::33060 :::* LISTEN 23582/mysqld
- tcp6 0 0 :::3306 :::* LISTEN 23582/mysqld
我們通過查看網絡端口偵聽的情況可以推測 mysqld 進程的參數設置。
三、賬戶密碼的問題
最后一種情況是賬戶密碼的問題,應付這種情況我們有個有力的工具就是查看 MySQL 的 error log, error log 記載信息的詳細程度上由參數 --log-error-verbosity 進行控制的,這個參數的作用如下:

默認為 2,設置為 3 可以記錄更多的信息,這個參數可以聯機設置:
- mysql> set global log_error_verbosity=3;
- Query OK, 0 rows affected (0.00 sec)
當密碼錯誤
- mysql -uroot -perrorpasswordmysql: [Warning] Using a password on the command line interface can be insecure.ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
在 MySQL 的 error log 里有這樣的記錄:
- 2020-11-03T07:59:40.720835Z 7 [Note] [MY-010926] [Server] Access denied for user 'root'@'localhost' (using password: YES)
看到這樣的記錄我們至少知道了客戶端是連接上了 MySQL 的服務的。如果把參數 --log-error-verbosity 設置成的默認值 2 時是沒有這個提示的,也就說沒有 note 類型的信息。
賬戶錯誤
- ERROR 1130 (HY000): Host '192.168.17.149' is not allowed to connect to this MySQL server
注意賬戶錯誤時,提示是 “is not allowed to connect to this MySQL server”,而密碼錯誤時是 “Access denied for user”。
MySQL 中的一個賬戶是由 user 和 host 兩個部分組成,在 MySQL 中有個 mysql 數據庫,里面有個 user 表,表中 Host 和 User 為兩個主鍵列(primary key),唯一表示一個用戶。像這種情況通常是 host 字段部分是 localhost,把它改成通配符 "%" 即可。