萬盛學電腦網

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

XAMPP 環境下 MySQL root 密碼修改完整指南(含 phpMyAdmin 聯動配置)

場景說明

XAMPP 預設 MySQL root 無密碼,生產/共享環境必須修改。修改後需同步更新 phpMyAdmin 設定,否則無法登入管理介面。

方法一:mysqladmin 命令列(最簡單、推薦)

# Windows CMD / PowerShell
cd C:\xampp\mysql\bin
mysqladmin.exe -u root password "new_strong_password"

# 驗證
mysql.exe -u root -p
# 輸入新密碼,進入 mysql> 提示符即成功

方法二:MySQL 客戶端 SQL 語句(通用)

mysql -u root -p  # 直接回車(無密碼)
-- 或已有密碼:mysql -u root -p'old_pwd'

-- MySQL 5.7 / 8.0 通用
ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_strong_password';
FLUSH PRIVILEGES;

-- 8.0 若報錯「does not match policy」需調整密碼策略或用更複雜密碼
-- 5.7 舊寫法(仍兼容)
SET PASSWORD FOR 'root'@'localhost' = PASSWORD('new_strong_password');
FLUSH PRIVILEGES;

方法三:UPDATE mysql.user 表(底層直改)

mysql -u root -p
USE mysql;
UPDATE user SET authentication_string = PASSWORD('new_strong_password') WHERE User = 'root' AND Host = 'localhost';
FLUSH PRIVILEGES;

⚠️ 8.0 欄位改為 authentication_string,且 PASSWORD() 函數已棄用,建議用 ALTER USER。

關鍵步驟:同步 phpMyAdmin 設定

編輯 config.inc.php

# 路徑:C:\xampp\phpMyAdmin\config.inc.php

// 1. 驗證模式:cookie(輸入密碼登入)或 config(配置寫死,不推薦)
$cfg['Servers'][$i]['auth_type'] = 'cookie';

// 2. 若用 config 模式,需寫死密碼(不安全,僅本地測試)
$cfg['Servers'][$i]['auth_type'] = 'config';
$cfg['Servers'][$i]['user'] = 'root';
$cfg['Servers'][$i]['password'] = 'new_strong_password';

修改後**重啟 Apache**(XAMPP Control Panel Stop/Start Apache),瀏覽 https://localhost/phpmyadmin 驗證登入。

常見問題排查

現象 原因 解決
phpMyAdmin 提示「無法連接 MySQL 服務器」 config.inc.php 密碼未同步、或 MySQL 未啟動 檢查 MySQL 服務狀態、同步密碼、重啟 Apache
修改密碼後命令列連不上 舊終端緩存舊密碼、或 Host 不匹配(localhost vs 127.0.0.1) 新開終端、指定 -h 127.0.0.1、檢查 user 表 Host 欄
忘記 root 密碼 -- 跳過權限表啟動:mysqld --skip-grant-tables → 進入修改 → 正常重啟
8.0 報錯 caching_sha2_password 不支援 舊驅動/客戶端不支援新認證插件 ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'pwd';

安全加固清單(修改密碼後必做)

  1. 刪除匿名用戶:DELETE FROM mysql.user WHERE User='';
  2. 禁止 root 遠程登入:DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost','127.0.0.1','::1');
  3. 刪除 test 資料庫:DROP DATABASE test; DELETE FROM mysql.db WHERE Db='test' OR Db='test\_%';
  4. 重新載入權限:FLUSH PRIVILEGES;
  5. 執行 mysql_secure_installation 互動式完成上述所有。

Linux/macOS XAMPP (LAMPP) 同樣適用

/opt/lampp/bin/mysqladmin -u root password "new_pwd"
# config.inc.php 路徑:/opt/lampp/phpmyadmin/config.inc.php
copyright © 萬盛學電腦網 all rights reserved