萬盛學電腦網

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

解決 MySQL "Access denied for user 'root'@'localhost'" 問題全流程

常見原因

  1. 密碼錯誤(含特殊字元未轉義)。
  2. mysql.user 表中無 root@localhost 或 Host 欄位不匹配(如只有 root@%)。
  3. 權限表損壞 / 權限快取未刷新。
  4. MySQL 8.0 預設認證插件 caching_sha2_password,舊客戶端不支援。

通用修復流程(適用 5.7/8.0)

步驟 1:跳過權限表啟動

# 停止服務
systemctl stop mysqld

# 跳過授權表啟動
mysqld_safe --skip-grant-tables --skip-networking &

# 另開終端,無密碼登入
mysql -u root

步驟 2:重設密碼並修正 Host

-- 5.7
USE mysql;
UPDATE user SET authentication_string=PASSWORD('NewPass123!') WHERE User='root' AND Host='localhost';
-- 若無 localhost 行,插入一條
INSERT INTO user (Host,User,Authentication_string) VALUES ('localhost','root',PASSWORD('NewPass123!'));

-- 8.0
USE mysql;
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'NewPass123!';
-- 或保留 caching_sha2_password
-- ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewPass123!';

FLUSH PRIVILEGES;

步驟 3:正常重啟

# 關閉 skip-grant-tables 進程
mysqladmin -u root -p shutdown
# 或 kill PID

# 正常啟動
systemctl start mysqld

# 驗證
mysql -u root -p'NewPass123!' -e "SELECT USER();"

Windows 環境圖形化修復

  1. 以管理員開啟「服務」,停止 MySQL。
  2. 建立文本檔 C:\mysql-init.txt,內容:
    ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewPass123!';
  3. CMD 執行:
    "C:\Program Files\MySQL\MySQL Server 8.0\bin\mysqld" --init-file=C:\mysql-init.txt --console
  4. 看到 "ready for connections" 後 Ctrl+C 停止,刪除 init 檔,重新啟動服務。

MySQL 8.0 認證插件問題專項

-- 查看當前認證插件
SELECT User, Host, plugin FROM mysql.user WHERE User='root';

-- 統一改為 mysql_native_password(相容舊驅動)
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'NewPass123!';
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'NewPass123!';
FLUSH PRIVILEGES;

預防最佳實踐

  • 安裝後立即執行 mysql_secure_installation 設定強密碼、移除匿名用戶、禁止 root 遠程登入。
  • 應用程式使用專用帳號,嚴禁直接用 root。
  • 密碼存放於 ~/.my.cnf 或密碼管理工具,避免腳本明文。
  • 定期審計 mysql.user 表,清理無用/過期帳號。

總結

Access denied 90% 為密碼或 Host 不匹配。跳過授權表啟動 → 修正 user 表 → FLUSH PRIVILEGES → 正常重啟 是通用修復鐵律。MySQL 8.0 額外注意認證插件相容性。

copyright © 萬盛學電腦網 all rights reserved