萬盛學電腦網

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

解決 mysqli 連線「No such file or directory」:localhost 與 127.0.0.1 的本質區別

現象

PHP CLI 或 Web 執行 new mysqli('localhost', 'root', 'pwd', 'db') 拋出:

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

將 localhost 改為 127.0.0.1 即正常。

根本原因:兩種傳輸協議

連線字串傳輸協議Socket/端口速度/安全
localhostUnix Domain Socket/var/lib/mysql/mysql.sock (或 /tmp/mysql.sock)更快、僅本機、無網絡開銷
127.0.0.1TCP/IP3306 端口標準網絡棧、可跨主機、稍慢

MySQL 客戶端庫根據主機名決定協議:localhost 強制走 Socket,127.0.0.1 強制走 TCP。若 Socket 檔案不存在、路徑不匹配、權限不足,即報「No such file or directory」。

三種解決方案(按推薦順序)

方案一:改用 127.0.0.1(最簡單、通用)


$mysqli = new mysqli('127.0.0.1', 'root', 'pwd', 'db', 3306);

繞過 Socket 直接走 TCP,無需任何配置修改。現代局域網/本機 TCP 延遲極低(<0.1ms),效能差異可忽略。

方案二:修正 my.cnf 指定 Socket 路徑


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

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

重啟 MySQL 後,PHP 端 localhost 會讀取 [client] 區段的 socket 參數。需確認實際 mysql.sock 位置(ls -l /var/lib/mysql/mysql.sock 或 mysql_config --socket)。

方案三:PHP 連線時顯式指定 Socket


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

第 5 參數為端口(Socket 模式下忽略),第 6 參數為 Socket 路徑。適用於無法修改 my.cnf 的共享主機環境。

進階知識點

  • 權限區別: MySQL 帳號 user@'localhost' 僅匹配 Socket 連線;user@'127.0.0.1' 僅匹配 TCP 連線;user@'%' 匹配 TCP 但不匹配 localhost。遷移協議時需同步授權。
  • SELinux/AppArmor: 可能阻止 httpd/php-fpm 訪問 /var/lib/mysql/mysql.sock,檢查 audit.log 或暫時 setenforce 0 測試。
  • PHP-FPM chroot: 若啟用 chroot,Socket 路徑需在 chroot 內映射或掛載。
  • Windows 環境: 無 Unix Socket,localhost 自動解析為 TCP 127.0.0.1,不會出現此錯誤。

排查清單

  1. ls -l /var/lib/mysql/mysql.sock 確認 Socket 存在。
  2. mysql -u root -p -S /var/lib/mysql/mysql.sock 測試 Socket 連線。
  3. netstat -lnpt | grep 3306 確認 TCP 監聽。
  4. php -r "var_dump(mysqli_connect('localhost','root','pwd'));" 對比 127.0.0.1。
  5. 檢查 php.ini mysqli.default_socket 設定。
copyright © 萬盛學電腦網 all rights reserved