萬盛學電腦網

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

解決 mysqli 連接 localhost 報錯:No such file or directory

問題現象

使用 PHP CLI 或 Web 方式連接 MySQL 時,若主機填寫 localhost,會拋出錯誤:

Warning: mysqli::mysqli(): (HY000/2002): No such file or directory
Connect Error (2002) No such file or directory

但將 localhost 改為 127.0.0.1 即可正常連接。

根本原因

MySQL 對兩種主機名的處理機制不同:

  • localhost:MySQL 採用 Unix Domain Socket(本地套接字)連接,需讀取 mysql.sock 檔案路徑。
  • 127.0.0.1:MySQL 採用 TCP/IP 協議連接,走網路回環介面。

Unix Socket 連接速度更快、更安全,但若 mysql.sock 路徑配置不一致,便會出現「找不到檔案」錯誤。

三種解決方案

方案一:改用 TCP/IP 連接(最簡單)

將連接主機從 localhost 改為 127.0.0.1:

// 物件導向風格
$mysqli = new mysqli('127.0.0.1', 'root', '123456', 'mysql');

// 程序風格
$con = mysqli_connect("127.0.0.1", "root", "123456", "mysql");

方案二:修改 MySQL 配置文件指定 socket 路徑

編輯 my.cnf(通常在 /etc/my.cnf 或 /etc/mysql/my.cnf),在 [mysqld] 與 [client] 區段加入:

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

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

路徑請根據實際情況調整(可用 find / -name mysql.sock 定位)。修改後重啟 MySQL 服務。

方案三:PHP 連接時顯式指定 socket 路徑

$db = new MySQLi('localhost', 'root', 'root', 'my_db', 3306, '/var/run/mysqld/mysqld.sock');

第 5 參數為端口(預設 3306),第 6 參數為 socket 檔案完整路徑。

補充說明

  • user@'%' 無法匹配 user@'localhost',權限設定時需注意。
  • 生產環境建議統一使用 127.0.0.1 避免 socket 路徑不一致問題。
copyright © 萬盛學電腦網 all rights reserved