PHP连接MySQL报错怎么解决？

PHP连接MySQL失败是开发中高频出现的棘手问题，常见错误如“Connection refused”“Access denied”或“Unknown database”往往并非单一原因所致，而是涉及服务状态、连接参数、用户权限、网络策略及PHP扩展等多层环节的连锁反应；本文系统梳理了五大核心排查方向——从确认MySQL服务是否正常运行、逐项核对主机、端口、凭据等连接配置，到检查用户Host绑定与权限分配，再到排除防火墙/SELinux拦截，最后验证mysqli或PDO扩展是否启用，每一步都配有精准命令和实操建议，助你快速定位根因、高效恢复数据库连接。

如果在PHP脚本中尝试连接MySQL数据库时出现错误，通常表现为mysqli_connect()或PDO::__construct()调用失败，并返回类似“Connection refused”、“Access denied”或“Unknown database”等提示。以下是针对该问题的多种排查与修复方法：

一、检查数据库服务是否运行

PHP无法连接MySQL的根本前提之一是MySQL服务未启动，此时连接请求会被系统直接拒绝。

1、在Linux服务器上执行命令 sudo systemctl status mysql 或 sudo service mysqld status 查看服务状态。

2、若显示 inactive，则运行 sudo systemctl start mysql 启动服务。

3、在Windows环境下，打开“服务”管理器，查找名为 MySQL80 或 MySQL 的服务，确认其状态为“正在运行”。

二、验证连接参数是否正确

PHP连接语句中使用的主机地址、端口、用户名、密码及数据库名必须与MySQL实际配置完全一致，任一字段错误均会导致连接失败。

1、确认PHP代码中使用的主机名不是 localhost（该值在部分系统中会强制走Unix socket），可尝试替换为 127.0.0.1 强制使用TCP/IP协议。

2、检查端口号是否为MySQL实际监听端口，默认为 3306；若修改过配置，需同步更新PHP连接字符串中的 port 参数。

3、使用命令行工具手动验证凭证：执行 mysql -u 用户名 -p -h 127.0.0.1 -P 3306，输入密码后观察是否能成功登录。

三、确认用户权限与主机绑定规则

MySQL用户账户不仅需存在，还必须被授权从PHP所在主机（可能是本地或远程）访问指定数据库，且账号未被限制来源IP或域名。

1、登录MySQL后执行 SELECT User, Host FROM mysql.user; 查看当前用户列表及其允许连接的Host值。

2、若PHP运行在本机但用户Host列为 localhost，而连接时使用的是 127.0.0.1，则可能因MySQL对二者视为不同主机而拒绝连接；此时应创建Host为 127.0.0.1 或 % 的同名用户。

3、执行 GRANT ALL PRIVILEGES ON 数据库名.* TO '用户名'@'%' IDENTIFIED BY '密码'; FLUSH PRIVILEGES; 授予必要权限并刷新权限表。

四、检查防火墙与SELinux限制

即使MySQL服务运行正常且凭据无误，网络层拦截也可能导致连接超时或被拒绝，尤其在云服务器或企业内网环境中常见。

1、在Linux服务器上运行 sudo ufw status（Ubuntu）或 sudo firewall-cmd --list-all（CentOS/RHEL）查看防火墙是否放行3306端口。

2、如未放行，执行 sudo ufw allow 3306 或 sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload 开启端口。

3、对于启用SELinux的系统，运行 sudo setsebool -P httpd_can_network_connect_db 1 允许Web服务器进程连接数据库。

五、验证PHP扩展是否启用

PHP需加载对应数据库驱动扩展（如mysqli或pdo_mysql）才能发起连接请求，缺少扩展将导致函数未定义或连接机制不可用。

1、在PHP脚本中插入 var_dump(extension_loaded('mysqli')); 或 var_dump(extension_loaded('pdo_mysql')); 检查扩展是否已加载。

2、若返回false，编辑php.ini文件，取消以下行的注释：extension=mysqli 和/或 extension=pdo_mysql（Windows下为 extension=php_mysqli.dll 等）。

3、保存php.ini后重启Web服务器（如Apache执行 sudo systemctl restart apache2，Nginx+PHP-FPM则执行 sudo systemctl restart php-fpm）。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。