查不到数据首先要检查$result是否为false，再查mysqli_error或PDO::errorInfo()；验证SQL字符串、排查隐式陷阱（如BOM、时间格式、类型转换）；确认事务状态与字符集一致性；最后分层判断查询失败、无结果、正常三种情况。
查不到数据，先看 $result 是不是 false
很多情况根本不是“有数据但没取出来”，而是 SQL 执行就失败了，但你没察觉。PHP 的 mysqli_query() 或 PDO::query() 成功时返回结果集对象/语句句柄，失败时直接返回 false。如果你跳过判断、直接调用 fetch_assoc()，就会报错或静默返回空数组。
- 立刻加一行：
var_dump($result);—— 如果是bool(false)，说明查询压根没执行成功 - 紧接着查错误：
echo mysqli_error($conn);或print_r($pdo->errorInfo());，常见报错如Unknown column 'user_name' in 'where clause'（字段名错了）、Table 'db.users' doesn't exist（表名或库名不对） - 别信拼接出来的
$sql字符串看起来“没问题”——用var_dump($sql)复制到 phpMyAdmin 里跑一遍，大小写、引号闭合、变量是否为空都一目了然
WHERE 条件看似匹配，其实全军覆没
数据明明在表里，SELECT * FROM user WHERE username = 'admin' 却查不到？大概率是隐式陷阱在作祟，尤其在 Linux 环境或含中文/空格/时间字段时。
- 检查值里有没有隐藏字符：执行
SELECT HEX(username), LENGTH(username) FROM user WHERE id = 1，看 HEX 值是不是多了EFBBBF（BOM）或空格字节 - 时间字段别只传日期：用
datetime类型却写WHERE created_at = '2026-02-01'，实际存的是'2026-02-01 14:22:05'，永远不等 —— 改用DATE(created_at) = '2026-02-01'或BETWEEN - 数字字段存的是字符串？比如
status VARCHAR(10)存着'active'，你却写WHERE status = 1，MySQL 会强行转成数字比，结果全变成 0 匹配不上
连上了、SQL 对了、也 fetch 了，还是空 —— 检查事务和连接状态
这问题多出现在 InnoDB 表 + 开启事务的场景，尤其在调试时手动 BEGIN 但忘了 COMMIT，或者用了长连接（PDO::ATTR_PERSISTENT => true）导致上一次事务没清干净。
- 在 PHP 查询前后，执行一句
SELECT @@tx_isolation, @@in_transaction;，确认当前是否处于未提交事务中 - 临时验证法：打开 MySQL 命令行，用同一账号执行完全一样的
SELECT，如果 CLI 能查到、PHP 查不到，基本锁定是事务隔离或连接复用问题 - 避免复用残留：开发期禁用持久连接；Swoole/Swoft 等常驻进程框架中，每次查询前手动
$pdo->exec('SET SESSION sql_mode = ""');清理会话状态
查不到不是 bug，是默认行为 —— 别忘了显式处理空结果
PHP 不会替你决定“没数据时该返回什么”。fetch() 返回 null、fetchAll() 返回空数组、num_rows 是 0 —— 这些都是合法且正常的返回值，不是错误。
立即学习“PHP免费学习笔记（深入）”；
- 不要只写
if ($row) { ... }就完事，$row可能是false（查询失败）或null（无数据），两者含义完全不同 - 推荐分层判断：
if ($result === false) { /* SQL 执行失败 */ } elseif ($result->num_rows === 0) { /* 有查询、无匹配 */ } else { /* 正常取数据 */ } - 容易被忽略的是字符集影响：连接层、表、字段三者字符集不一致（比如连接用
utf8，字段是utf8mb4），中文条件可能完全失效，务必在 PDO DSN 加;charset=utf8mb4，或 mysqli 中调用mysqli_set_charset($conn, 'utf8mb4')
