mysqli_fetch_assoc返回null的常见原因：一是mysqli_query执行失败返回false，导致传入非法参数；二是查询成功但无匹配记录，属正常行为。必须先检查查询是否成功，再判断返回是否为null。
mysqli_fetch_assoc 返回 NULL 的常见原因
直接调用 mysqli_fetch_assoc 却拿不到数据，大概率不是函数写错了，而是前面的查询没成功或结果集为空。它只从已执行的查询结果中取下一行，不负责执行 SQL，也不自动重试。
- 必须先用
mysqli_query执行 SELECT，且返回的是有效mysqli_result对象（不是false） - 如果 SQL 语法错、表名错、连接断开，
mysqli_query返回false，再传给mysqli_fetch_assoc就会触发警告：“expects parameter 1 to be mysqli_result” - 即使查询成功，但没匹配到记录（比如 WHERE 条件太严），
mysqli_fetch_assoc也会返回null—— 这是正常行为，不是错误
获取单条数据的标准写法（带错误检查）
真正安全的做法是分三步：执行查询 → 检查是否成功 → 检查是否有数据。别跳过中间任何一环。
$sql = "SELECT id, name FROM users WHERE id = 123";
$result = mysqli_query($conn, $sql);
<p>if ($result === false) {
// 查询失败：检查 mysqli_error($conn)
die('Query failed: ' . mysqli_error($conn));
}</p><p>$row = mysqli_fetch_assoc($result);
if ($row === null) {
// 查询成功但无匹配行
echo "No user found";
} else {
echo $row['name'];
}注意：mysqli_fetch_assoc 是“移动式读取”，调一次取一行，再调就取下一行。单条查询只需调一次，不用循环。
为什么不用 mysqli_fetch_array 或 mysqli_fetch_row？
这三个函数底层都操作同一结果集指针，区别只在返回格式：mysqli_fetch_assoc 只返回关联数组（键是字段名），mysqli_fetch_row 只返回数字索引数组，mysqli_fetch_array 默认两者都返回（浪费内存）。对单条数据且明确按字段名访问的场景，mysqli_fetch_assoc 最清晰、最不易出错。
立即学习“PHP免费学习笔记（深入）”；
- 字段名变更时，
$row['email']比$row[2]更易维护 - 避免因字段顺序变化导致的静默错位（尤其 SELECT * 或 JOIN 场景）
- PHP7.3 中三者性能差异可忽略，语义明确更重要
容易被忽略的资源释放问题
很多人以为取完一条就完事了，其实 $result 仍占用内存和 MySQL 连接资源。虽然脚本结束会自动释放，但在长生命周期脚本（如 CLI 工具、循环处理多条记录）里不释放，可能触发“too many connections”错误。
- 单条查询后建议立即调用
mysqli_free_result($result) - 如果后续还要用同一个
$result（比如再取第二条），就不能提前 free - 注意：free 之后再调
mysqli_fetch_assoc会返回null，且不报错 —— 容易误判为“没数据”
字段名大小写敏感性取决于 MySQL 表定义和配置，PHP 层面一律按建表时的大小写来写键名，别假设它会自动转小写。
