PHP语言源码搭建数据库连接失败排查疑难解答

PHP源码搭建时数据库连不上，不是代码写错了，而是环境、配置、权限、扩展几个环节中某一处没对上。关键不是猜，是按顺序验证——先让错误说话，再一层层往下压。

立即捕获真实错误信息

别让连接失败沉默。在 mysqli_connect() 或 new PDO() 后必须加错误输出：

• mysqli：用 if (!$conn) { echo "错误：" . mysqli_connect_error(); exit; }
• PDO：用 try-catch 包裹，catch (PDOException $e) { echo $e->getMessage(); }

常见错误直读：

• Connection refused → MySQL服务没启动，或端口被拦
• Access denied for user → 用户名/密码错，或 'user'@'host' 不匹配
• Unknown MySQL server host → host 值拼错、DNS不通、容器名写错
• No such file or directory → localhost 走 socket 失败，换 127.0.0.1 即可

确认MySQL服务真正在运行且监听正确

一键环境（如phpStudy、XAMPP）里“绿色图标”不等于服务活着：

立即学习“PHP免费学习笔记（深入）”；

• 打开控制面板，看 MySQL 状态是否为“已启动”；若失败，点“日志”查 mysql_error.log
• 命令行验证：Windows 运行 netstat -ano | findstr :3306，Linux/macOS 运行 ss -tlnp | grep 3306
• 检查 my.cnf 或 my.ini：确认没有 skip-networking，且 bind-address = 127.0.0.1 或 0.0.0.0（非仅 ::1）

核对连接参数与用户授权细节

账号密码对 ≠ 能连上，“user”@“host”这个组合必须严丝合缝：

• 登录 MySQL 执行：SELECT User, Host FROM mysql.user;，看你要用的用户对应 Host 是 localhost、127.0.0.1 还是 %
• 本地开发统一用 127.0.0.1（强制走 TCP），避免 localhost 因 socket 路径引发歧义
• Docker 或远程场景下，用户 Host 必须是具体 IP 或 %，并执行：GRANT ALL ON your_db.* TO 'user'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;

检查PHP扩展是否启用且版本兼容

哪怕参数全对，pdo_mysql 或 mysqli 没开，连接就卡在第一步：

• 运行 php -m | grep -i pdo（Linux/macOS）或 php -m（Windows 手动查找），确认 pdo、pdo_mysql、mysqli 都在列表中
• Laravel 要求 ctype、json、mbstring；Symfony 需 intl；Laravel 10+ 要求 PHP ≥ 8.1
• MySQL 8.0+ 默认用 caching_sha2_password 认证插件，PHP 7.4 以下不支持 → 执行：ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass'; FLUSH PRIVILEGES;