php8数据库连接报错本质是环境、代码、权限未对齐，须逐层验证：启用mysqli/pdo_mysql扩展并重启服务；代码改用new mysqli()或pdo+errmode_exception；.env密码含特殊字符需urlencode；mysql用户host须匹配localhost或127.0.0.1。
PHP8数据库连接配置错误导致页面报错、白屏或提示“Class 'mysqli' not found”“Access denied for user”等，本质是环境、代码、权限三者中至少有一处没对齐，必须逐层验证。
确认MySQL扩展是否真实启用
打开 php.ini 文件，搜索 extension=mysqli 和 extension=pdo_mysql；把前面的分号 ; 全部删掉。
再找 extension_dir = "ext" 这一行，确保它没被注释，并且路径指向你 PHP 安装目录下的 ext 文件夹（例如 Windows 下是 C:/php/ext，Linux 下可能是 /usr/lib/php/2023xxxx/ext）。
保存后重启 Web 服务器（Apache 或 Nginx + PHP-FPM），否则修改不生效。
新建 test.php，内容为 ，浏览器访问，Ctrl+F 搜索 “mysqli” 和 “pdo_mysql”，看到 “enabled” 才算真正启用。如果只看到 “mysqli support → disabled”，说明 extension_dir 路径写错了或 DLL 文件缺失。
检查数据库连接代码是否适配 PHP8
方法一：用 mysqli 面向对象方式（推荐初学者）
替换旧写法 mysql_connect()（PHP7已移除），改用：
$conn = new mysqli('localhost', 'root', 'your_pass', 'test_db');
if ($conn->connect_error) { die('连接失败: ' . $conn->connect_error); }
注意：mysqli 构造函数第四个参数直接传数据库名，不用再调用 mysqli_select_db()。
方法二：用 PDO（更安全、支持预处理）
写法必须带错误模式声明，否则出错不报具体信息：
$dsn = 'mysql:host=localhost;dbname=test_db;charset=utf8mb4';
$pdo = new PDO($dsn, 'root', 'your_pass', [【PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION】]);
这句不能省——PHP8 默认就是 EXCEPTION 模式，但显式写出能避免低版本迁移时踩坑。
排查 .env 或配置文件中的敏感项失效
第一步：确认 APP_DEBUG=true 已开启（ThinkPHP 等框架必需）；否则 .env 根本不加载。
第二步：.env 文件必须放在项目根目录，和 index.php 同级，不是 config/ 或 app/ 下。
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
第三步：键名严格全大写+下划线，DB_PASSWORD=abc123 有效，db_password 或 DB_password 都读不到。
第四步：在控制器里加一行 dump(env('DB_PASSWORD'));，输出 null 就说明上面任一条件未满足。
第五步：密码里含特殊字符（如 @ / : / ?）必须 URL 编码，例如 password@123 要写成 password%40123，否则 DSN 解析会截断。
验证 MySQL 用户 host 匹配精度
登录 MySQL 命令行，执行：
SELECT User, Host FROM mysql.user WHERE User = 'root';
如果只返回 'root'@'localhost'，但 PHP 用的是 DB_HOST=127.0.0.1，则连接会被拒绝——MySQL 把 'localhost' 和 '127.0.0.1' 当作两个用户。
解决方法二选一：
① 改 PHP 配置：DB_HOST 明确设为 localhost（强制走 socket 连接）；
② 改 MySQL 用户：运行 CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY 'your_pass'; GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1'; FLUSH PRIVILEGES;
【切勿直接 UPDATE mysql.user 表，权限结构复杂易锁死】
快速定位真实错误来源
打开 runtime/log/ 目录，找最新那条以 .log 结尾的文件，用文本编辑器打开，搜索 PDOException。
重点看 message 字段结尾括号里的内容：
“(using password: YES)” → 密码错或用户不存在；
“(using password: NO)” → DB_PASSWORD 为空、null 或被 trim 成空字符串；
“Connection refused” → MySQL 服务没开或端口不通；
“Unknown MySQL server host” → DB_HOST 域名无法解析。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
