MySQL錯誤ERROR 2003 (HY000) Can't connect to MySQL server .' (111)

在MySQL中，如果訪問/連接MySQL資料庫時遇到“ERROR 2003 (HY000): Can't connect to MySQL server on 'xxx.xxx.xxx.xxx:xxx' (111)”這個錯誤，我們應該從哪些方面進行考慮和排查問題呢？ 下圖是我總結整理的一個思維導圖，在遇到這個錯誤時的排查方向和排查思路，

下面來演示/介紹一個比較特殊的案例，在服務器上訪問當前主機的MySQL時遇到了“ERROR 2003 (HY000): Can't connect to MySQL server on '127.0.0.1:7306' (111)”

$ mysql -h 127.0.0.1 -u test -p  --port=7306
Enter password: 
ERROR 2003 (HY000): Can't connect to MySQL server on '127.0.0.1:7306' (111)
$ perror 111
OS error code 111:  Connection refused

其實訪問本地MySQL，根本不用檢查127.0.0.1這個IP是否能ping通，不過為了以防萬一，我們還是驗證一下

$ ping 127.0.0.1
PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.
64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.046 ms
64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.073 ms
64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.071 ms
64 bytes from 127.0.0.1: icmp_seq=4 ttl=64 time=0.072 ms
64 bytes from 127.0.0.1: icmp_seq=5 ttl=64 time=0.071 ms
^C
--- 127.0.0.1 ping statistics ---
5 packets transmitted, 5 received, 0% packet loss, time 4099ms
rtt min/avg/max/mdev = 0.046/0.066/0.073/0.013 ms

檢查MySQL實體狀態

然后我們檢查一下MySQL服務是否正常，MySQL實體是否Crash掉了，

方式1：

$ sudo systemctl status mysqld.service
● mysqld.service - MySQL Server
   Loaded: loaded (/usr/lib/systemd/system/mysqld.service; enabled; vendor preset: disabled)
   Active: active (running) since Mon 2023-03-13 15:01:43 CST; 1 weeks 2 days ago
     Docs: man:mysqld(8)
           http://dev.mysql.com/doc/refman/en/using-systemd.html
 Main PID: 143115 (mysqld)
   Status: "Server is operational"
    Tasks: 47 (limit: 49256)
   Memory: 1.4G
   CGroup: /system.slice/mysqld.service
           └─143115 /opt/mysql/mysql8.0/bin/mysqld --defaults-file=/data/conf/my.cnf

Mar 13 15:01:40 yictmysqlu01 systemd[1]: Starting MySQL Server...
Mar 13 15:01:43 yictmysqlu01 systemd[1]: Started MySQL Server.

方式2：

ps -Af | grep mysqld | grep -v grep
mysql     143115       1  1 Mar13 ?        03:47:43 /opt/mysql/mysql8.0/bin/mysqld --defaults-file=/data/conf/my.cnf

如上所示，MySQL實體正常的，所以可以排除MySQL實體關倍訓MySQL實體Crash的情況，

檢查MySQL的監聽埠

使用下面命令檢查MySQL的監聽埠

$ netstat -lnp | grep mysql
(Not all processes could be identified, non-owned process info
 will not be shown, you would have to be root to see it all.)
tcp        0      0 192.168.9.203:7306      0.0.0.0:*               LISTEN      143115/mysqld       
tcp6       0      0 :::33060                :::*                    LISTEN      143115/mysqld       
unix  2      [ ACC ]     STREAM     LISTENING     3188552  143115/mysqld        /tmp/mysqlx.sock
unix  2      [ ACC ]     STREAM     LISTENING     3191315  143115/mysqld        /tmp/mysql.sock

如上所示，監聽埠為7306，訪問MySQL時指定的埠號也是7306，沒有什么毛病，因此也可以排查這個因素，

檢查引數bind-address

檢查MySQL的組態檔中的bind-address引數

方式1：

$ grep bind_address my.cnf
bind_address=192.168.9.203

方式2：

mysql> SELECT VARIABLE_NAME, VARIABLE_VALUE
    -> FROM performance_schema.global_variables
    -> WHERE VARIABLE_NAME = 'bind_address';
+---------------+----------------+
| VARIABLE_NAME | VARIABLE_VALUE |
+---------------+----------------+
| bind_address  | 192.168.9.203   |
+---------------+----------------+
1 row in set (0.01 sec)

mysql>

bind-address的設定有以下三種情況：

bind-address=127.0.0.1  #只允許本機訪問，
bind-address=某個網卡的ip #例如bind-address=192.168.9.203，只能通過ip為192.168.9.203的網卡訪問，
bind-address=0.0.0.0    #此規則是系統默認配置，監聽所有網卡，即允許所有ip訪問，

這里由于設定引數bind_address=192.168.9.203，所以當我們使用127.0.0.1訪問資料庫就會被拒絕，從而拋出上面的錯誤，

那么這里有一個問題，如果資料庫里面創建了兩個賬號test@'127.0.0.1'和test@'localhost'，那么test@'localhost'是否也會遇到這個錯誤呢？你的答案是會還是不會呢? 正確答案是不會，因為localhost和127.0.0.1兩者是有所區別的(下面部分內容來自參考資料^[1])：

一、原理不同：

localhost的原理是不經網卡傳輸，不會受到網卡協議的限制，設定程式時本地服務用localhost，localhost不會決議成IP，也不會占用網卡、網路資源， 127.0.0.1的原理是經過網卡傳輸的，依賴網卡協議，并受到網卡相關協議的限制，使用IP訪問的時候，等于本機是通過網路再去訪問本機，會涉及到網路用戶的權限，

二、概念不同

localhost：也可以叫是local，正確的解釋是：本地服務器的意思，它可以被配置為任意的IP地址可以通過hosts這個檔案進行更改，不過通常情況下都指向：127.0.0.1 127.0.0.1：在windows系統的正確解釋是：本機地址的意思，127.0.0.1是保留地址之一，用來檢驗本機TCP/IP協議堆疊，可以Ping回送地址，如果回送地址Ping不通，就說明IP堆疊出了故障，如果通的話，表明網路出了問題，

三、指向不同

localhost是一個保留域名(RFC 2606) ，為了避免同狹義定義主機名混淆而單獨列出，它不僅指向 127.0.0.1 這個IP地址，它同時還可以指向ipv6 的地址 ， 127.0.0.1 是回送地址，指本地機，測驗使用，回送地址（127.x.x.x）是本機回送地址（Loopback Address），即主機IP堆疊內部的IP地址，主要用于網路軟體測驗以及本地機行程間通信，無論什么程式，一旦使用回送地址發送資料，協議軟體立即回傳，不進行任何網路傳輸，

具體原因如下：

mysql -h 127.0.0.1 訪問MySQL的時候，使用 TCP/IP 連接

mysql -h localhost 訪問MySQL的時候，它不會使用 TCP/IP 連接的，而使用Unix socket；此時，MySQL Server則認為該 client 是來自 “localhost”

參考資料