萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

解決 MySQL 連線錯誤:Can't connect to MySQL server (10060)

錯誤代碼 10060 (ETIMEDOUT) 表示連線嘗試超時,即客戶端無法在預期時間內與 MySQL 伺服器建立 TCP 連線。這通常不是認證失敗,而是**網路層面的阻隔**。本文提供系統化排查步驟,快速定位並解決問題。

一、 錯誤現象

使用 Navicat、Workbench 或命令列連線遠端 MySQL 時,報錯:

Can't connect to MySQL server on 'x.x.x.x' (10060)

連線錯誤 10060 截圖

二、 排查邏輯:三大核心嫌疑點

  1. MySQL 綁定位址限制 (bind-address)
  2. 用戶帳號主機限制 (user.host 欄位)
  3. 網路/防火牆阻擋 (Security Group, iptables, firewalld, Windows 防火牆)

三、 逐步排查指南

1. 檢查用戶帳號主機權限

登入 MySQL,查詢用戶 Host 欄位:

SELECT User, Host FROM mysql.user WHERE User = 'your_user';
用戶權限檢查
  • Host = '%':允許任意 IP 連線 ✅
  • Host = 'localhost' 或 '127.0.0.1':僅允許本機連線 ❌ 需修改為 '%' 或具體客戶端 IP。
  • 修改命令:
    RENAME USER 'user'@'localhost' TO 'user'@'%';
    FLUSH PRIVILEGES;

2. 檢查 MySQL 配置 bind-address

編輯配置檔(/etc/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf):

[mysqld]
# bind-address = 127.0.0.1  ← 註釋掉或改為 0.0.0.0
bind-address = 0.0.0.0
配置檔檢查

修改後必須重啟 MySQL:systemctl restart mysqld。

3. 檢查伺服器防火牆(最常見原因)

Linux (firewalld/iptables):

# firewalld
firewall-cmd --zone=public --add-port=3306/tcp --permanent
firewall-cmd --reload

# iptables
iptables -A INPUT -p tcp --dport 3306 -j ACCEPT
service iptables save
防火牆狀態

雲廠商安全組(AWS SG / 阿里雲安全組 / 華為雲安全組):

  • 入站規則:協議 TCP,埠 3306,來源 0.0.0.0/0(或限定辦公 IP)。

Windows Server 防火牆:

netsh advfirewall firewall add rule name="MySQL 3306" dir=in action=allow protocol=TCP localport=3306

4. 驗證網路連通性

在客戶端機器執行:

# Telnet 測試埠連通性
telnet  3306

# 或 nc (netcat)
nc -zv  3306

# 或 PowerShell
Test-NetConnection -ComputerName  -Port 3306
  • 若連線成功 → 問題在 MySQL 設定(用戶/bind-address)。
  • 若連線超時/被拒 → 問題在防火牆/安全組/網路 ACL。

5. 臨時關閉防火牆驗證(僅測試環境)

# CentOS 7+
systemctl stop firewalld

# Ubuntu
ufw disable
關閉防火牆後連線成功

若關閉防火牆後即可連線,確認是防火牆規則問題,按上述規則放行埠 3306 並重新啟用防火牆。

四、 其他潛在原因

原因檢查/解決
MySQL 服務未啟動systemctl status mysqld 確認 running
埠被佔用/衝突netstat -antp | grep 3306 或 ss -antp | grep 3306
SELinux 阻擋setsebool -P mysql_connect_any 1 或暫時 setenforce 0
雲端私有網路 (VPC) 路由/ACL 錯誤檢查子網路 ACL、路由表、NAT 閘道配置
客戶端 VPN/代理干擾關閉 VPN/代理嘗試直連

五、 總結檢查清單

  1. ✅ MySQL 服務運行中
  2. ✅ bind-address = 0.0.0.0 (或具體內網 IP)
  3. ✅ 用戶 Host 為 '%' 或客戶端 IP
  4. ✅ 伺服器防火牆放行 TCP 3306
  5. ✅ 雲端安全組入站規則放行 TCP 3306
  6. ✅ telnet ip 3306 連通

依序核對,99% 的 10060 錯誤可在前 3 步解決。生產環境務必**僅開放必要 IP 存取**,避免直接暴露 3306 至公網。

copyright © 萬盛學電腦網 all rights reserved