萬盛學電腦網

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

MySQL 密碼正確卻無法本地登入?缺失 localhost 權限項完整修復

錯誤現象

ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

密碼確定正確,且 127.0.0.1、% 可登入,唯獨 localhost 失敗。

根本原因

MySQL 權限表 mysql.user 中,**缺少 Host='localhost' 的 root 記錄**。

MySQL 將 localhost(Unix Socket)與 127.0.0.1(TCP/IP)視為**完全不同的主機**。權限匹配順序:

  1. 精確匹配 User+Host
  2. 通配符 % 匹配

若無 localhost 記錄,且 % 記錄也缺失或權限不足,則拒絕連線。

驗證方法

# 以可登入帳號進入(如 127.0.0.1 或 skip-grant-tables)
mysql -u root -p -h 127.0.0.1
# 查看 root 所有記錄
SELECT User, Host, plugin FROM mysql.user WHERE User='root';
-- 典型缺失輸出:
-- +------+-----------+-----------------------+
-- | User | Host      | plugin                |
-- +------+-----------+-----------------------+
-- | root | %         | caching_sha2_password |
-- | root | 127.0.0.1 | caching_sha2_password |
-- | root | ::1       | caching_sha2_password |
-- +------+-----------+-----------------------+
-- 缺少 localhost 行!

修復方案(三種任選一)

方案一:UPDATE 現有記錄(最快)

-- 需先以 skip-grant-tables 或 127.0.0.1 登入
UPDATE mysql.user SET Host='localhost' WHERE User='root' AND Host='%';
FLUSH PRIVILEGES;

方案二:INSERT 新記錄(最清晰)

INSERT INTO mysql.user (Host, User, authentication_string, plugin)
VALUES ('localhost', 'root', '*HASH_VALUE', 'caching_sha2_password');
-- HASH_VALUE 從現有 root 記錄複製
FLUSH PRIVILEGES;

方案三:重建 root@localhost(最徹底)

-- 1. 刪除所有 root 記錄(謹慎!需有其他管理員帳號)
DELETE FROM mysql.user WHERE User='root';
-- 2. 重建三條標準記錄
CREATE USER 'root'@'localhost' IDENTIFIED BY 'NewPass123!';
CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY 'NewPass123!';
CREATE USER 'root'@'::1' IDENTIFIED BY 'NewPass123!';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION;
GRANT ALL PRIVILEGES ON *.* TO 'root'@'::1' WITH GRANT OPTION;
FLUSH PRIVILEGES;

進入 skip-grant-tables 模式步驟

Linux/macOS

systemctl stop mysqld
mysqld_safe --skip-grant-tables --skip-networking &
mysql -u root
# 執行上述修復 SQL
# 修復後
mysqladmin shutdown
systemctl start mysqld

Windows

net stop MySQL80
mysqld --skip-grant-tables --skip-networking
# 新開 CMD 視窗
mysql -u root
# 執行修復 SQL
# 結束 mysqld 進程 (Ctrl+C 或任務管理員)
net start MySQL80

驗證修復

mysql -u root -p -h localhost -e "SELECT CURRENT_USER();"
# 應顯示 root@localhost

預防措施

  • 安裝/升級後執行 mysql_secure_installation,會自動建立完整 root 記錄
  • 避免手動刪除 mysql.user 記錄
  • 使用配置管理工具維護用戶權限

總結

「密碼正確但無法本地登入」90% 是缺少 root@localhost 權限記錄。理解 MySQL Host 匹配機制,通過 skip-grant-tables 緊急進入修復,或直接補齊三條標準記錄(localhost、127.0.0.1、::1),即可徹底解決。建議所有環境統一維護三條 root 記錄,避免此類問題復發。

copyright © 萬盛學電腦網 all rights reserved