萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

解決 phpMyAdmin 無法連接 MySQL 的常見原因與修復步驟

問題現象

在 WAMP 環境中嘗試使用 phpMyAdmin 連接 MySQL 時,出現「服務器拒絕連接」錯誤,提示檢查 config.inc.php 中的主機、用戶名和密碼設定。MySQL 錯誤日誌顯示服務正常啟動並監聽 3306 端口,但 phpMyAdmin 仍無法建立連線。

常見原因分析

  • 配置文件參數錯誤:config.inc.php 中的 $cfg['Servers'][$i]['host']、user、password 與 MySQL 實際設定不一致。
  • MySQL 服務未正確綁定:MySQL 僅綁定 127.0.0.1,而 phpMyAdmin 嘗試用 localhost 或主機名連接,導致協議不匹配(TCP vs Socket)。
  • 防火牆/殺毒軟體攔截:本地端口 3306 被安全軟體阻擋。
  • MySQL 用戶權限問題:root 用戶缺少從特定主機連接的權限,或密碼插件不兼容(如 caching_sha2_password)。

排查與修復步驟

  1. 核對 config.inc.php
    打開 phpMyAdmin/config.inc.php,確認以下設定:
    $cfg['Servers'][$i]['host'] = '127.0.0.1'; // 建議用 IP 而非 localhost
    $cfg['Servers'][$i]['port'] = '3306';
    $cfg['Servers'][$i]['user'] = 'root';
    $cfg['Servers'][$i]['password'] = 'your_password'; // 若無密碼留空
    $cfg['Servers'][$i]['auth_type'] = 'cookie'; // 或 'config'
    
  2. 檢查 MySQL 服務狀態
    在命令列執行 net start mysql(Windows)或 systemctl status mysqld(Linux),確認服務運行中。日誌顯示 ready for connections 表示服務正常。
  3. 測試命令列連接
    在 MySQL bin 目錄下執行:
    mysql -h 127.0.0.1 -u root -p
    
    若能進入 MySQL Shell,說明服務端無誤,問題在 phpMyAdmin 配置。
  4. 調整 MySQL 用戶宿主
    登入 MySQL 後執行:
    SELECT User, Host FROM mysql.user;
    
    確保 root 允許從 127.0.0.1 或 % 連接。若需修改:
    ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'new_password';
    FLUSH PRIVILEGES;
    
  5. 重啟服務並清除快取
    重啟 Apache、MySQL 服務,清除瀏覽器快取後重試 phpMyAdmin。

進階建議

若問題持續,檢查 php.ini 中 mysqli.default_socket 或 pdo_mysql.default_socket 是否指向正確的 Socket 文件(Linux 下通常為 /var/run/mysqld/mysqld.sock)。生產環境建議禁用 root 遠程登入,改用專用低權限帳號。

copyright © 萬盛學電腦網 all rights reserved