PHP 8.0 数据库连接失败的核心问题在于环境适配与配置细节，需四步排查：一、临时开启错误显示并启用PDO异常模式以暴露真实错误；二、用mysql命令行直连验证底层服务；三、检查PHP 8.0与MySQL 8.0认证插件兼容性；四、核对.env加载、密码URL编码、host拼写及云服务器安全组等高频细节。
PHP 8.0 网站数据库连接失败，核心问题往往不在代码本身，而在于环境适配、配置细节和底层服务状态。PHP 8.0 默认启用 PDO 异常模式，但若没正确捕获或没开启错误显示，你看到的可能只是白屏或“500 错误”，根本看不到真实原因。
第一步：强制暴露真实错误信息
别猜，先让 PHP 把话说明白。在入口文件（如 index.php 或测试脚本开头）临时加入：
<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);
?>
如果是 PDO 连接，务必设置异常模式：
立即学习“PHP免费学习笔记（深入）”；
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
]);
这样报错会直接显示类似：
SQLSTATE[HY000] [2002] Connection refused（服务没启/端口错）
SQLSTATE[HY000] [1045] Access denied for user（账号密码或 host 不对）
SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client（MySQL 8.0 认证插件不兼容）
第二步：绕过框架，用命令行直连验证
框架配置再漂亮，也得底层服务通才行。打开终端，执行：
mysql -h 127.0.0.1 -P 3306 -u your_user -p
注意三点：
• 用 127.0.0.1 而非 localhost（避免 Unix socket 解析干扰）
• -P 是大写，指定端口（默认 3306，改过就填对）
• 如果这一步都连不上，说明不是 PHP 的问题，而是 MySQL 服务、防火墙、用户权限或网络本身的问题
第三步：重点检查 PHP 8.0 与 MySQL 8.0 的兼容性
这是 PHP 8.0 环境下最典型的“静默失败”场景：
- MySQL 8.0 默认认证插件是 caching_sha2_password，PHP 8.0+ 基本支持，但某些旧扩展或 Docker 镜像仍可能出问题
- 如果报错含 authentication plugin 字样，进 MySQL 执行：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass';
FLUSH PRIVILEGES; - 确认 pdo_mysql 已启用：
php -m | grep pdo_mysql（必须有输出） - Docker 用户注意：Alpine 镜像需额外安装扩展，例如：
apk add php82-pdo_mysql（版本号要严格匹配）
第四步：核对配置中容易忽略的细节
拼写错误、特殊字符、环境加载失效——这些才是高频雷区：
- .env 文件是否真被读到？ Laravel/ThinkPHP 等框架依赖 APP_DEBUG=true 才加载 .env；临时加一行 dump(env('DB_HOST')); 看输出是不是 null
- 密码含 @ / : / ? 等字符？ 必须 URL 编码后填入 DSN，比如密码是 p@ss:w0rd，DSN 中要写成 p%40ss%3Aw0rd
- host 写的是 localhsot？ 多一个字母、少一个字母，参数全对也白搭
- 云服务器（阿里云/RDS）注意安全组：3306 端口要放行，且 MySQL 用户 host 必须是 % 或具体公网 IP，不能是 localhost
