PHP连接MySQL数据库报错咋办_PHP数据库连不上常见原因排查【解答】

PHP连接MySQL失败需依次排查：一、确认MySQL服务运行；二、核对连接参数（主机、端口、凭据）；三、检查用户权限与Host绑定；四、排除防火墙/SELinux拦截；五、确保mysqli或pdo_mysql扩展已启用。

如果在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 启动服务。

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

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或域名。

Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.

访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。

下载

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）。