PHP 模板部署報錯：MySQL 拒絕 root@localhost 連接

錯誤信息

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

排查清單

1. 配置文件檢查：模板中的 config.php 或 .env 是否修改為本地數據庫實際賬號密碼？
2. 用戶權限：MySQL 中 root@localhost 是否允許密碼登錄？
   SELECT user, host, plugin FROM mysql.user WHERE user='root';
   若 plugin 為 auth_socket，需改為 mysql_native_password：
   ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;
3. 主機匹配：若應用連接 127.0.0.1，MySQL 需授權 root@'127.0.0.1' 或 root@'%'。
4. 防火牆/SELinux：確認 3306 端口對本地進程開放。

快速驗證

mysql -u root -p -h 127.0.0.1 -P 3306

命令行能連上說明網絡與賬號無誤，問題在應用配置；否則按上述權限修復。