mysqli_connect()返回false或PDO报HY000/1045错误，本质是环境链路中断，需按服务状态→扩展启用→连接参数→用户权限→认证插件顺序排查，跳步无效；PHP 8.5.5对认证插件、超时、扩展加载更严格，localhost与127.0.0.1因socket/TCP路径不一致常致连通性差异，须显式校验socket路径或改用IP直连。
mysqli_connect() 返回 false 或 PDO 抛出 HY000/1045 错误，基本不是代码写错，而是环境链路上某个环节断了。PHP 8.5.5 本身不引入连接兼容性问题，但对认证插件、超时行为、扩展加载更严格——得按顺序排查，跳步容易白忙活。
mysqli_connect() 一调就报错：先看服务和扩展在不在
连不上最常卡在这两步：MySQL根本没跑，或者PHP压根不认识mysqli。
- Linux/macOS 执行
sudo systemctl status mysql（或mariadb），看到active (running)才算真启动；如果显示inactive (dead)，直接sudo systemctl start mysql - Windows 用户打开
services.msc，找名字带MySQL的服务（比如MySQL80），右键“启动”，并设为“自动” - 运行
php -m | grep -i mysqli，没输出？说明扩展没启用。查php --ini输出的Loaded Configuration File路径，编辑对应php.ini，确认有这行且没被分号注释：extension=mysqli（Linux/macOS）或extension=php_mysqli.dll（Windows） - Debian/Ubuntu 用户如果用
apt装的 PHP，还得补装驱动：sudo apt install php-mysqlnd（比php-mysql更推荐，支持原生协议）
localhost 和 127.0.0.1 连不通？端口和 socket 路径在打架
用 mysql -h localhost -u root -p 能登，但 PHP 里 mysqli_connect("localhost", ...) 失败？大概率是 localhost 触发了 Unix socket 连接，而 PHP 和 MySQL 的 socket 路径不一致。
- 终端执行
mysql -h 127.0.0.1 -P 3306 -u root -p测试 TCP 连接。成功 → 说明 MySQL 监听 TCP，PHP 里就把 host 改成"127.0.0.1"，别用"localhost" - 检查 MySQL 是否真监听 3306：
sudo ss -tuln | grep :3306。没输出？去/etc/mysql/my.cnf（或/usr/local/etc/my.cnf）确认bind-address是127.0.0.1或0.0.0.0，不是127.0.0.1却被防火墙拦了 - 如果坚持用
"localhost"，得确保 PHP 和 MySQL 的 socket 路径一致。查 MySQL 的 socket：mysql -e "SHOW VARIABLES LIKE 'socket';"；再在 PHP 中显式传参：new mysqli("localhost", $user, $pass, $db, 3306, "/var/run/mysqld/mysqld.sock")
PDO 构造失败报 HY000/1045：用户名密码被当常量用了
PDO 报 Access denied for user 'username'@'localhost'，90% 是因为没加引号，PHP 把 username 当成未定义常量，自动转成字符串字面量 "username"。
- 错误写法：
new PDO("mysql:host=localhost", username, password);——username和password没引号，PHP 解析成常量，找不到就当字符串 - 正确写法：
new PDO("mysql:host=localhost;dbname=test", "root", "your_pass");，所有凭据必须是字符串字面量或变量 - 额外验证：进 MySQL 执行
SELECT user, host, plugin FROM mysql.user WHERE user='root';，如果plugin是caching_sha2_password（MySQL 8.0+ 默认），PHP 8.5.5 需要 OpenSSL 支持，或临时切回mysql_native_password：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES;
连接卡住或超时：PHP 8.5.5 对握手更敏感
PHP 8.5.5 默认握手超时更短，遇到慢响应或认证延迟容易直接断开，表现为 Error while reading greeting packet 或脚本卡死。
立即学习“PHP免费学习笔记（深入）”；
- 给
mysqli加连接选项：$link = mysqli_init(); mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5); mysqli_real_connect($link, $host, $user, $pass, $db, $port, $socket, MYSQLI_CLIENT_SSL); - PDO 可在 DSN 后加
connect_timeout=5："mysql:host=localhost;connect_timeout=5;" - 别把 Web 服务器端口（如 8080）误填进 MySQL 端口参数——MySQL 默认就是
3306，除非你改过配置
