php 7.4数据库查询报错致白屏或500错误，根本原因是未校验查询结果有效性就调用fetch_*方法；需添加调试代码显错、三重校验mysqli结果、pdo启用异常模式并try-catch捕获。
PHP 7.4 数据库查询报错时，页面常出现白屏、500错误或“Call to a member function fetch_assoc() on bool”类致命提示，根本原因不是数据库宕机，而是代码未校验查询结果有效性就直接调用方法，或连接/语法/权限等前置环节已失败。
确认错误类型并定位源头
第一步：在出错页面顶部添加临时调试代码：error_reporting(E_ALL); ini_set('display_errors', '1');，强制显示完整错误信息。
第二步：查看错误内容——若提示 Call to a member function fetch_*() on bool，说明 mysqli_query() 或 $pdo->query() 返回了 【false】，但代码仍当作对象调用方法；若提示 Connection refused 或 Access denied，问题在连接层而非SQL执行后。
第三步：打开 PHP 错误日志（路径见 php --ini 输出的 Loaded Configuration File 中 error_log 配置项），用 tail -f /var/log/php-fpm/www-error.log 实时捕获报错堆栈，比浏览器显示更完整。
修复 mysqli 查询未判空直接 fetch 的错误
方法一：用三重校验结构兜底
执行查询后必须依次判断连接是否有效 → 查询是否成功 → 结果是否可迭代。缺任何一环都可能触发 fatal error：
$result = mysqli_query($conn, "SELECT * FROM users WHERE id = 1");
if (!$conn) { die("数据库连接失败: " . mysqli_connect_error()); }
if ($result === false) { die("查询执行失败: " . mysqli_error($conn)); }
if (is_object($result) && method_exists($result, 'fetch_assoc')) { while ($row = $result->fetch_assoc()) { /* 处理数据 */ } }
这一步不能省略：PHP 7.4 对类型更严格，false 和 mysqli_result 对象混用会直接中断脚本。
修复 PDO 查询中未捕获异常导致静默失败
方法一：启用 PDO 严格错误模式
创建 PDO 实例时必须显式设置 PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则 SQL 错误只会返回 false，不抛异常：
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);
方法二：用 try-catch 包裹查询逻辑
try {
$stmt = $pdo->query("SELECT * FROM non_existent_table");
$rows = $stmt->fetchAll();
} catch (PDOException $e) {
error_log("数据库查询异常: " . $e->getMessage());
echo "系统繁忙，请稍后再试";
}
不加 try-catch 且未开启异常模式时，$pdo->query() 出错只返回 false，后续调用 fetchAll() 会报 “Call to a member function fetchAll() on bool”，错误位置指向调用行而非真实 SQL 错误处。
验证并修复底层连接问题
检查 MySQL 连接参数是否写错：主机地址是否用了 127.0.0.1 却没开 TCP 连接（应改用 localhost 走 socket），端口是否被防火墙拦截，用户名密码是否含特殊字符未 urlencode。
在终端执行命令直连验证：mysql -u your_user -p -h 127.0.0.1 -P 3306 your_dbname，若命令行也无法登录，说明是数据库侧配置问题，与 PHP 无关。
若报错 SQLSTATE[HY000] [2002] Connection refused，重点检查 MySQL 是否运行：systemctl status mysqld；若报错 Access denied for user，需登录 MySQL 执行 SELECT User, Host FROM mysql.user; 确认用户存在且 Host 匹配当前连接来源。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
