mysqli课程搜索改用参数绑定后出现查询异常的问题排查

两次异常的核心根因 #

第一次调整页面直接崩溃的常见诱因 #

• 预处理占位符和绑定参数的数量、类型不匹配：SQL中设置了2个?占位符，但bind_param时只传入1个参数值，或者类型字符串（bind_param的第一个入参）长度和占位符数量不一致，触发PHP致命错误导致页面白屏。
• 绑定结果变量前未加载结果集：执行预处理语句后直接调用bind_result，未先通过store_result()把结果集拉取到客户端，部分PHP版本会因状态不匹配抛异常。
• 绑定的结果变量数量和SELECT查询返回的列数不一致，触发类型匹配错误。

第二次调整页面可加载但无搜索结果的核心bug #

这是mysqli预处理写LIKE查询的最高发错误：把%通配符和?占位符拼接在同一段SQL字符串的单引号内。

典型错误写法（即第二次调整时大概率写出的问题代码）：

SELECT course_name, course_code FROM course_list 
WHERE course_name LIKE '%?%' OR course_code LIKE '%?%'

此时预处理驱动会将单引号内的?识别为普通字符串的一部分，不会当做待替换的占位符，最终执行的查询完全无法匹配模糊查询的预期逻辑，自然返回空结果。

可正常运行的实现步骤 #

• 预处理SQL语句中，占位符完全独立放置，不要和SQL内的字符串引号、通配符拼接。
• 提前构造带%包裹的搜索关键词，作为绑定参数的值传入，不要把%写进SQL语句中。
• 严格按照占位符的出现顺序，一一对应传入绑定值，保证类型字符串、参数值数量和占位符数量完全一致。
• 执行语句后先加载结果集，再绑定结果变量，避免版本兼容问题。

参考可运行代码 #

// 获取并校验表单输入的搜索关键词
$rawKeyword = trim($_POST['search_keyword'] ?? '');
// 构造模糊匹配的参数值
$likeMatch = "%{$rawKeyword}%";

// 正确的SQL结构，占位符独立存在，无单引号包裹
$sql = "SELECT course_name, course_code, credit FROM course_list 
        WHERE course_name LIKE ? OR course_code LIKE ?";

$stmt = $mysqli->prepare($sql);
// 两个占位符均为字符串类型，依次传入匹配参数
$stmt->bind_param("ss", $likeMatch, $likeMatch);
$stmt->execute();
// 先存储结果集，避免bind_result兼容问题
$stmt->store_result();
// 绑定结果变量，数量和SELECT返回列数完全一致
$stmt->bind_result($cName, $cCode, $cCredit);

// 遍历输出匹配结果
while ($stmt->fetch()) {
    echo "<div>课程名：{$cName} | 课程代码：{$cCode} | 学分：{$cCredit}</div>";
}

调试排查要点 #

• 出现崩溃时优先打印$stmt->error查看具体报错，不要只看白屏猜测问题原因。
• 确认SQL中?的位置没有被单引号、双引号包裹，否则会失去占位符作用。
• 确认bind_param的第一个参数字符串长度、后续传入的参数个数，和SQL中占位符的总数完全相等。

内容的提问来源于stack exchange，提问作者peterthegreat1853