排查PHP数据库连接问题，第一步永远是要找到日志在哪里。在CentOS环境下，PHP错误日志藏在哪里，主要看用的是哪种Web服务器——PHP-FPM、Apache还是Nginx，路径各有不同。
1. 定位PHP错误日志文件
常见的日志路径有这么几个：
- 如果用的是PHP-FPM，去
/var/log/php-fpm/error.log找 - Apache的话，默认在
/var/log/httpd/error_log - Nginx则通常放在
/var/log/nginx/error.log
想要快速定位问题，可以打开终端，用 tail -f /var/log/php-fpm/error.log（记得替换成你实际的路径）实时盯着日志输出。这样能第一时间看到错误发生的时间点和具体类型，比满屏瞎猜要高效得多。
2. 分析日志中的数据库连接错误信息
日志里的错误信息通常不会太含蓄，基本会直接告诉你问题出在哪。常见的几类错误值得留意：
- 连接失败类：比如“Connection refused”“Host ‘xxx’ is not allowed to connect”，或者“Can’t connect to MySQL server on ‘localhost’ (111)”。这类信息基本是在说，PHP想连数据库，但对方没理你。
- 认证失败类：典型的就是“Access denied for user ‘root’@‘localhost’ (using password: YES)”。用户名或密码不对，没什么好说的。
- 扩展缺失类：如果看到“Call to undefined function mysqli_connect()”或者“Class ‘PDO’ not found”，那说明PHP还没装对应的数据库扩展。
- 超时类：比如“Maximum execution time exceeded”或“Connection timed out”，往往是网络不通或者数据库响应太慢。
看一眼错误信息，方向基本就出来了——是配置问题、权限问题，还是扩展没装，心里就有数了。
3. 检查数据库配置参数
接下来，回到PHP代码里，确认一下数据库连接配置。无论是用 mysqli_connect() 还是PDO的DSN，重点检查这么几个参数：
- 主机名：是
localhost还是IP地址？如果数据库在远程服务器上，必须用IP，别写localhost骗自己。 - 端口：MySQL默认是
3306，但如果你改了数据库配置，记得保持一致。 - 用户名和密码：区分大小写，别手误。
- 数据库名：确保数据库确实存在，可以登录MySQL命令行用
SHOW DATABASES;验证一下。
还可以用 phpinfo() 函数看看当前PHP加载的配置，重点关注 mysqli.default_host 和 pdo_mysql.default_socket 这些参数是否对得上。
4. 验证数据库服务器状态
数据库服务器是否在正常运行，这是最基础的一步。用命令检查一下：
# 检查MySQL服务状态
sudo systemctl status mysqld
# 如果是MariaDB，命令类似
# 如果没启动，就启动它
sudo systemctl start mysqld
# 顺便设置开机自启
sudo systemctl enable mysqld
再用 netstat -tulnp | grep 3306（或者你用的数据库端口）确认一下，数据库是否在正确的端口上监听。
5. 检查网络与防火墙设置
- 网络连通性：先试试
ping <数据库服务器IP>，看看PHP服务器和数据库服务器之间能否互通。如果不通，那就得排查网络问题了。 - 防火墙配置：如果数据库服务器开启了防火墙（比如
firewalld或ufw），记得放行数据库端口。以MySQL为例：
# firewalld（CentOS 7+）
sudo firewall-cmd --permanent --add-port=3306/tcp
sudo firewall-cmd --reload
# ufw（Ubuntu）
sudo ufw allow 3306/tcp
如果数据库就在本地，可以临时关闭防火墙测试一下（sudo systemctl stop firewalld），但生产环境千万别这么干。
6. 确认PHP数据库扩展是否启用
PHP要连数据库，得先装好对应的扩展，比如 mysqli 或 pdo_mysql。怎么检查？
- 打开
php.ini文件（路径可以通过phpinfo()的“Loaded Configuration File”找到），确认下面两行没有被注释掉（前面没有;）：
extension=mysqli.so
extension=pdo_mysql.so
- 修改完
php.ini后，记得重启PHP服务让扩展生效：
sudo systemctl restart php-fpm # 如果用的是PHP-FPM
sudo systemctl restart httpd # 如果用的是Apache
- 最后，用
phpinfo()搜索“mysqli”或“pdo_mysql”，确认扩展已经正常加载。
7. 检查数据库用户权限
连接数据库的用户，需要具备相应的权限，比如 SELECT、INSERT、CONNECT 这些。操作步骤如下：
- 登录数据库服务器：
mysql -u root -p
- 授权用户，比如允许
user1从localhost连接mydb数据库：
GRANT ALL PRIVILEGES ON mydb.* TO 'user1'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
- 如果用户需要从远程服务器连接，可以把
localhost换成%（允许所有IP），或者指定具体的IP：
GRANT ALL PRIVILEGES ON mydb.* TO 'user1'@'%' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
8. 查看数据库服务器日志
如果以上步骤都走了一遍还是没找到问题，那就得看数据库服务器自己的日志了。比如MySQL的错误日志通常位于 /var/log/mysql/error.log，里面会记录更详细的失败原因，比如“Too many connections”或“Aborted connection”之类的，针对性解决就好。
