PHP连接MySQL失败怎么解决

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《PHP连接MySQL失败排查指南》，聊聊，希望可以帮助到正在努力赚钱的你。

PHP连不上MySQL的首要原因是mysqli或PDO_mysql扩展未启用，需检查php.ini配置并重启Web服务；其次确认MySQL进程运行、监听地址及端口开放；最后排查用户权限与认证插件兼容性。

PHP 连不上 MySQL：先确认 mysqli 或 PDO_mysql 扩展是否启用

绝大多数“连不上”的问题，根源不在密码或地址，而在 PHP 根本没加载数据库驱动。Windows 下常见于 php.ini 中扩展被注释；Linux 下则可能是扩展未安装或配置路径错误。

• 运行 php -m | grep -i mysql（Linux/macOS）或 php -m（Windows 查看输出），确认列表中含 mysqli 和/或 pdo_mysql
• 若无，编辑 php.ini，取消注释对应行：

  ;extension=mysqli

  → 改为

  extension=mysqli

  （Windows）；Linux 常需 sudo apt install php-mysql 后重启 Web 服务
• 改完必须重启 Web 服务（apache2 / nginx + php-fpm），仅重启 PHP 进程无效

连接报错 Connection refused 或 Can't connect to local MySQL server

说明 PHP 尝试连接 MySQL，但 MySQL 进程未监听指定地址或端口，或被防火墙拦截。

• 先确认 MySQL 是否在运行：sudo systemctl status mysql（Linux）或任务管理器查 mysqld.exe（Windows）
• 检查 MySQL 监听地址：mysql -u root -p -e "SHOW VARIABLES LIKE 'bind_address';"。若值为 127.0.0.1，则只接受本地 IPv4；若为 ::1，可能拒绝 IPv4 连接 —— PHP 中显式用 '127.0.0.1' 而非 'localhost' 可绕过 socket 机制
• 验证端口是否开放：telnet 127.0.0.1 3306（Linux/macOS 可用 nc -zv 127.0.0.1 3306）。失败则检查 skip-networking 是否被启用（my.cnf 中需注释掉该行）

连接成功但提示 Access denied for user

不是密码错了，就是用户权限没给对——MySQL 8+ 默认认证插件变更，是高频踩坑点。

• 登录 MySQL 后执行：

  SELECT host, user, plugin FROM mysql.user WHERE user = 'your_user';

  ，重点看 plugin 列。若为 caching_sha2_password（MySQL 8.0.4+ 默认），而 PHP 版本 openssl 扩展，就会拒连
• 临时解决（开发环境）：

  ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;

• 确保授权包含目标 host：GRANT ALL ON *.* TO 'user'@'127.0.0.1' 和 GRANT ALL ON *.* TO 'user'@'localhost' 是两条独立权限，不能互相替代

PHP 连接代码里最容易漏掉的三个参数

写死 localhost、忽略端口、不设字符集，这三处出错不会直接报错，但会导致中文乱码、超时或莫名断连。

• 显式指定端口，尤其当 MySQL 非默认 3306：$mysqli = new mysqli('127.0.0.1', 'user', 'pass', 'db', 3307);
• 连接后立即设置字符集：$mysqli->set_charset('utf8mb4');（注意是 utf8mb4，不是 utf8）
• 使用 PDO 时，DSN 中加入 ;charset=utf8mb4，并设置 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则错误静默失败

MySQL 的权限模型和 PHP 扩展加载机制是两套独立系统，排查时别混在一起判断。一个 phpinfo() 页面就能快速定位是驱动缺失还是连接参数错，比反复改密码有效得多。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~