在 PHP 中执行 SELECT 查询时，如果最终拿到空结果，并不代表数据表里一定没有符合条件的记录。真正的原因可能出在 SQL 条件拼写、结果集读取方式、数据库连接参数甚至错误报告被关闭等多个环节。先厘清一个关键点：数据库返回空结果通常分为两种情况，一种是 SQL 执行成功但确实没有匹配行，另一种是 SQL 执行失败或结果集没有被正确解析，却被代码误判为空数据。下面的排查顺序可以帮助快速定位问题。
一、先确认 SQL 语句是否真的执行成功
很多人第一步会直接在数据库管理工具里跑同样的 SQL，发现能查到数据，于是怀疑是 PHP 代码的问题。但更常见的情况是：PHP 里的 SQL 因为变量拼接、引号转义或字段名写错，实际执行的语句和预期并不一致。此时 mysqli_query 或 PDO 的 query 会返回 false，但是如果代码没有检查返回值，后续 fetch 操作就会得到空结果。
建议在调试阶段把完整的 SQL 语句输出到页面或日志文件。尤其是包含 WHERE 条件、LIKE、IN、BETWEEN 等子句时，一定要确认最终发送给数据库的字符串。下面这段 mysqli 代码演示了如何检查执行结果和输出错误信息：
<?php
$mysqli = new mysqli('127.0.0.1', 'root', 'password', 'test_db');
if ($mysqli->connect_errno) {
die('连接失败: ' . $mysqli->connect_error);
}
$keyword = $_GET['keyword'] ?? '';
$sql = "SELECT id, title FROM articles WHERE title LIKE '%" . $mysqli->real_escape_string($keyword) . "%'";
$result = $mysqli->query($sql);
if ($result === false) {
echo 'SQL错误: ' . $mysqli->error;
echo '完整SQL: ' . $sql;
exit;
}
echo '查询成功，记录数: ' . $result->num_rows;
?>
上面的代码先判断 $result 是否为 false，再读取 num_rows。如果 SQL 中有语法错误，比如字段名写错、关键字拼错，错误信息会立刻显示出来。忽略这一步是导致空结果被误判的最主要原因。
二、检查 PHP 结果集读取逻辑是否正确
当 SQL 执行成功并返回结果集后，不同的扩展和函数对结果的判断方式并不一样。例如 mysqli 中，num_rows 只对 SELECT 等返回结果集的语句有效；而 affected_rows 用于 INSERT、UPDATE、DELETE。如果查询的是 SELECT，却用 affected_rows 判断行数，很可能得到 0。另一个常见错误是重复调用 fetch 方法。fetch_assoc、fetch_array、fetch_row 每次调用都会移动内部指针，第二次调用时可能已经到达末尾，从而得到 null 或空数组。
PDO 用户则容易混淆 rowCount 的适用范围。PDOStatement::rowCount 在部分数据库中对于 SELECT 查询并不总是返回实际行数，尤其在某些驱动或未缓冲查询下，它可能返回 0。更可靠的做法是直接使用 fetchAll 后统计数组长度，或者通过 while 循环逐行读取并累计。下面是一个 PDO 的示例：
<?php
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test_db;charset=utf8mb4', 'root', 'password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
$stmt = $pdo->prepare('SELECT id, title FROM articles WHERE category_id = :category_id');
$stmt->execute(['category_id' => 3]);
$rows = $stmt->fetchAll();
echo '实际读取到 ' . count($rows) . ' 条记录';
foreach ($rows as $row) {
echo $row['title'] . PHP_EOL;
}
?>
如果使用 while ($row = $stmt->fetch()) 读取，需要注意不要在同一个 $stmt 上先调用一次 fetch 再进入 while，这样会跳过第一条数据。如果查询结果只有一条，第二次读取就会返回 false，表现为空结果。因此建议统一使用 foreach 加 fetchAll，或者保持 while 作为唯一读取入口。
三、排查连接参数、字符集与错误报告等隐藏因素
有些空结果并不是 SQL 或读取逻辑的问题，而是连接到了错误的数据库、使用了错误的表前缀，或者字符集不一致导致 WHERE 条件中的中文、Emoji 无法匹配。比如数据库连接时没有设置 utf8mb4，而表使用 utf8mb4 存储，查询中文条件时可能因为字符集转换失败导致匹配不到数据，此时 SQL 执行成功但结果为空。
另外，PHP 环境中如果关闭了错误显示，例如 error_reporting 设置为 0，或者 display_errors 为 Off，那么 SQL 执行失败时页面不会有任何提示。代码继续执行 fetch 就会得到空结果。排查这类问题时，可以在开发环境临时开启错误报告，并记录数据库返回的 warning。mysqli 的 error 属性和 PDO 的 errorInfo 方法都能提供具体错误码和描述。
下面这些点也需要逐一确认：
- 是否连接到了生产库而非本地测试库，表名、库名是否一致
- WHERE 条件中变量类型是否匹配，例如数据库中字段是字符串，而 PHP 传入的是整型，虽然 MySQL 可能自动转换，但某些严格模式下会匹配失败
- 字段名大小写是否一致，在 Linux 下 MySQL 表名和库名区分大小写，字段名通常不区分，但别名和引用方式可能有影响
- LIMIT 参数是否为 0 或负数，LIMIT 0 会直接返回空结果
- 事务是否已提交，如果使用了 InnoDB 且开启事务，未 commit 的修改或读取隔离级别可能导致查不到最新数据
- 查询条件中的 NULL 比较是否正确，使用 = NULL 永远匹配不到，必须使用 IS NULL
为了避免这些问题，建议在开发阶段统一使用异常模式。PDO 可以设置 ERRMODE_EXCEPTION，mysqli 可以通过 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT) 让错误直接抛出异常。这样任何 SQL 执行失败都不会被静默忽略，空结果的误判会大幅减少。
四、用最小化测试快速定位问题
当面对复杂查询返回空结果时，可以先用一个最简单的查询判断连接和结果读取是否正常。例如先执行 SELECT 1 或 SELECT COUNT(*) 从目标表统计行数。如果这个查询能返回数据，说明连接、库选择、结果集读取基本没有问题，问题很可能出在 WHERE 条件或 JOIN 逻辑上。然后再逐步增加条件、字段和关联表，直到复现空结果。
同时，建议把 SQL 语句复制到数据库管理工具中，并用相同的参数执行。如果在管理工具中能查到数据，就要对比 PHP 中实际发送的 SQL 是否完全一致。可以使用 MySQL 的 general log 或慢查询日志查看 PHP 实际执行的语句，也可以把变量拼接后的完整 SQL 写入文件。这样能快速发现引号、转义、空格、全角字符等细微差异。
排查空结果的本质是对比三件事：预期的 SQL、实际执行的 SQL、数据库返回的结果。任何一环不一致都可能导致空结果。掌握这个思路后，遇到 PHP 查询无数据的问题，就不会只停留在检查 SQL 条件这一层，而是从执行、读取、环境三个维度同步排查。