萬盛學電腦網

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

MySQL 無法用 localhost 連接(只能用 127.0.0.1):Socket vs TCP 徹底講透

現象

PHP 用 localhost 連不上,改 127.0.0.1 即正常。命令行 mysql -h localhost 卻正常。

根本原因:兩種協議,兩套權限

連接方式協議MySQL 權限表 host 值PHP 默認行為
localhostUnix Socket'localhost'mysqli/PDO 默認走 socket
127.0.0.1TCP/IP'127.0.0.1' 或 '%'指定 host=127.0.0.1 走 TCP

Socket 文件路徑不匹配 → 連接失敗。

解決方案一:修正 PHP 的 socket 路徑(推薦)

  1. 查詢 MySQL socket 位置:
    mysqld --verbose --help | grep socket
    輸出如:/var/run/mysqld/mysqld.sock
  2. 編輯 php.ini:
    mysql.default_socket = /var/run/mysqld/mysqld.sock
    mysqli.default_socket = /var/run/mysqld/mysqld.sock
    pdo_mysql.default_socket = /var/run/mysqld/mysqld.sock
  3. 重啟 PHP-FPM / Apache:systemctl restart php-fpm

解決方案二:統一用 127.0.0.1(最省事)

應用配置全部改為 host=127.0.0.1,強制走 TCP,繞過 socket 完全。需確保:

  • my.cnf 未設 skip-networking
  • bind-address = 127.0.0.1 或 0.0.0.0
  • 用戶權限含 'user'@'127.0.0.1'

無法用 127.0.0.1 連接的排查

  1. SELinux 阻擋 httpd 連 3306:setsebool -P httpd_can_network_connect_db 1 或暫時 setenforce 0
  2. 防火牆/雲安全組未放行 3306
  3. MySQL 錯誤日誌無連接記錄 → 連接包未到達 MySQL 層
  4. 系統日誌 /var/log/messages 或 journalctl -u mysqld 看 SELinux 拒絕訊息
copyright © 萬盛學電腦網 all rights reserved