下面给你一篇实战导向 + 可直接解决问题的完整技术文章，适合做博客、技术文档或排错手册。
PHP 8.1 与 MySQL 8.0 权限认证问题解决方案（全流程详解）
一、问题背景：为什么 PHP 8.1 连不上 MySQL 8.0？
在使用 PHP 8.1 + MySQL 8.0 的组合时，很多人会遇到类似报错👇
SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client
或：
Authentication plugin 'caching_sha2_password' is not supported
📌 核心原因一句话：
MySQL 8.0 默认认证方式变了，而 PHP 的 MySQL 客户端（mysqlnd）不完全兼容
二、问题根源解析（必须搞懂）
1️⃣ MySQL 8.0 默认认证方式变化
从 MySQL 8.0 开始：
| 版本 | 默认认证插件 |
|---|---|
| MySQL 5.7 | mysql_native_password |
| MySQL 8.0 | caching_sha2_password |
而很多 PHP 环境：
- 使用的是 旧版 mysqlnd
- 或 PDO / mysqli 未编译支持新认证插件
👉 导致 PHP 无法识别 MySQL 8.0 的认证方式
2️⃣ PHP 8.1 本身没问题，问题在扩展
重点说明👇
❌ 不是 PHP 8.1 不支持 MySQL 8.0
✅ 是 MySQL 认证插件 与 PHP MySQL 扩展不匹配
三、最常见的报错场景汇总
| 报错信息 | 原因 |
|---|---|
| authentication method unknown | 认证插件不支持 |
| Access denied for user | 用户权限或 host 错误 |
| SQLSTATE[HY000] [2054] | mysqlnd 不兼容 |
| Can’t connect to MySQL server | 端口/防火墙 |
四、解决方案一（最推荐）：修改 MySQL 用户认证方式 ⭐⭐⭐⭐⭐
✅ 思路
把 MySQL 8.0 用户的认证方式改回 mysql_native_password
1️⃣ 登录 MySQL
mysql -u root -p
2️⃣ 查看当前用户认证方式
SELECT user, host, plugin
FROM mysql.user;
你会看到类似：
user | host | plugin
-------+------+-----------------------
test | % | caching_sha2_password
3️⃣ 修改用户认证插件（关键步骤）
ALTER USER 'test'@'%'
IDENTIFIED WITH mysql_native_password
BY '你的密码';
4️⃣ 刷新权限
FLUSH PRIVILEGES;
✅ 90% 的 PHP + MySQL 8.0 连接问题到此结束
五、解决方案二：创建兼容用户（推荐生产环境）
不动原有账号，单独给 PHP 用一个用户 👇
CREATE USER 'phpuser'@'%'
IDENTIFIED WITH mysql_native_password
BY 'strong_password';
GRANT ALL PRIVILEGES ON your_db.* TO 'phpuser'@'%';
FLUSH PRIVILEGES;
📌 优点
- 安全
- 不影响其他系统
- 可控权限范围
六、解决方案三：升级 PHP MySQL 驱动（进阶）
如果你不想改 MySQL 认证方式：
1️⃣ 确认 mysqlnd 版本
php -i | grep mysqlnd
建议版本：
mysqlnd 8.1.x
2️⃣ 确认 PHP 编译支持
php -m | grep mysqli
php -m | grep pdo_mysql
3️⃣ Docker / 源码编译用户注意
如果你用的是：
- Docker
- 自编译 PHP
需要确保：
--with-mysqli=mysqlnd
--with-pdo-mysql=mysqlnd
📌 但现实中，仍不如方案一稳定
七、PHP 代码连接示例（PDO & mysqli）
1️⃣ PDO 示例（推荐）
$dsn = "mysql:host=127.0.0.1;dbname=test;charset=utf8mb4";
$user = "phpuser";
$pass = "strong_password";
$pdo = new PDO(
$dsn,
$user,
$pass,
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]
);
2️⃣ mysqli 示例
$conn = new mysqli(
"127.0.0.1",
"phpuser",
"strong_password",
"test"
);
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
八、常被忽略的 3 个坑（高频）
❌ 1️⃣ host 不一致
'user'@'localhost'
'user'@'%'
PHP 远程连接时：
- localhost ≠ %
❌ 2️⃣ MySQL 8 强制 SSL
某些环境需要关闭：
ALTER USER 'phpuser'@'%' REQUIRE NONE;
❌ 3️⃣ 密码加密方式未更新
改插件但没改密码 ❌
必须 重新指定密码
九、生产环境推荐方案总结（直接照做）
👉 最佳实践组合
| 项目 | 建议 |
|---|---|
| MySQL | 8.0 |
| PHP | 8.1 |
| 认证插件 | mysql_native_password |
| 用户 | 独立 PHP 用户 |
| 权限 | 最小权限原则 |
十、一句话总结（面试 / 文档可用）
PHP 8.1 连接 MySQL 8.0 的权限问题，本质是认证插件不兼容，最稳定的解决方案是将 MySQL 用户认证方式切换为 mysql_native_password。
发表回复