PHP 8.5 连不上 MySQL 需分四层排查：一、MySQL服务未运行，用systemctl status mysql或服务管理器确认；二、PHP扩展未加载，查phpinfo()并启用mysqli/pdo_mysql；三、凭据或权限错误，用mysql -h 127.0.0.1命令行验证，注意localhost与127.0.0.1区别及MySQL 8.0+认证插件兼容性；四、代码参数传错，如变量未加$符、环境变量未加载、错误处理不完整。
一、MySQL服务根本没跑起来
这是最基础也最容易忽略的一环。PHP再配置得再对，后端没服务，等于给空气发请求。
- Linux 执行：
sudo systemctl status mysql或sudo service mysqld status，看是否显示 active (running) - 若为 inactive，运行
sudo systemctl start mysql启动 - Windows 用户打开「服务」管理器，找 MySQL80 或类似名称的服务，确认状态为「正在运行」
- 顺便检查端口：默认 3306 是否被占？
sudo netstat -tuln | grep :3306；若无输出，说明 MySQL 没监听或 bind-address 配错了
二、PHP扩展压根没加载成功
PHP 8.5 对扩展加载更严格——扩展缺失或未启用，new mysqli() 或 PDO 构造会直接报 Fatal error，根本走不到密码校验那步。
- 先验证：写个
phpinfo.php页面，访问它，搜索 mysqli 和 pdo_mysql，确认两模块都出现且状态为 enabled - 若没看到：Ubuntu/Debian 系统执行
sudo apt install php8.5-mysql（注意版本号匹配）；CentOS/RHEL 用sudo yum install php-mysqlnd - 检查
php.ini：找到;extension=mysqli和;extension=pdo_mysql，删掉前面的分号；改完必须重启 PHP-FPM（如sudo systemctl restart php8.5-fpm）和 Web 服务器（Nginx/Apache） - 错误日志里若出现 Class "mysqli" not found，100% 是扩展没加载
三、凭据或权限卡在 MySQL 门口
报 Access denied for user 'xxx'@'localhost'（1045 错误），说明 PHP 已连上 MySQL，但被当场拒之门外——这不是网络问题，是身份核验失败。
- 别靠猜，用命令行交叉验证：
mysql -h 127.0.0.1 -P 3306 -u your_user -p，输入密码。能登进去 → 凭据没问题，问题出在 PHP 的 host 写法或 socket 路径；登不进 → 密码/用户名真错了 - 注意
localhost和127.0.0.1在 MySQL 中是两个不同 host：前者走 Unix socket，后者走 TCP。PHP 用localhost却连不上，换成127.0.0.1常常就通了 - 查用户允许来源：
SELECT User, Host FROM mysql.user WHERE User = 'your_user';。如果 Host 是localhost，而 PHP 从127.0.0.1连，就会被拒绝。解决：建一个'your_user'@'127.0.0.1'用户，或直接用'your_user'@'%'（生产慎用） - MySQL 8.0+ 默认认证插件是
caching_sha2_password，旧驱动可能不兼容——但此时报错是 Authentication plugin cannot be loaded，不是 1045，别混淆
四、代码里埋了低级但致命的坑
很多“连不上”其实是 PHP 自己把参数传错了，而不是数据库拒绝。
立即学习“PHP免费学习笔记（深入）”；
-
变量没加引号：写成
$pdo = new PDO($dsn, username, password)—— PHP 把username当常量，结果传的是字符串字面值"username"，不是变量值。正确写法：$pdo = new PDO($dsn, $username, $password) -
环境变量没加载：比如用
$user = $_ENV['DB_USER'] ?? ''，但.env根本没读，或putenv()没调用，导致传空密码过去 -
mysqli 错误处理太糙：只写
if (!$conn) die("失败")，掩盖真实原因。应写：if (!$conn) { error_log("DB connect failed: " . mysqli_connect_error()); die("服务暂不可用"); } -
PDO 没设异常模式：默认 PDO 不抛异常，错在静默。加一句
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);，错误立刻暴露
