bind_result字段数不匹配错误排查：PHP调用存储过程异常

兄弟，这个坑我以前也踩过！你盯着字段数对比半天觉得没问题，但实际上问题出在存储过程的分支逻辑里：当传入的booktitle为空时，你的存储过程根本没有返回任何结果集，这才导致了bind_result报错。

问题根源分析 #

看你的存储过程代码：

delimiter $
create procedure getbooksbytitle(booktitle char(200))
BEGIN
  DECLARE searchterm CHAR(201);
  set searchterm = "%";
  IF CHAR_LENGTH(booktitle) > 0 THEN
    set searchterm = concat(booktitle,'%');
    SELECT gb.book_id, gb.title,gb.isbn,gb.isbn13,gb.pubyear,gp.pubname 
    FROM grbooks gb 
    JOIN grpublishers gp ON (gp.publisher_id=gb.publisher_id) 
    WHERE gb.title LIKE searchterm;
  END IF;
END $
delimiter ;

只有当booktitle长度大于0时，才会执行SELECT语句返回结果集。如果用户传入的title是空字符串（比如表单没填就提交），IF条件不成立，存储过程啥也不返回。但你的PHP代码不管三七二十一，直接执行bind_result——这时候没有结果集可以绑定，自然就抛出“变量数和预处理语句字段数不匹配”的错误了。

两种解决方案 #

方案1：修改存储过程，确保始终返回结果集

把SELECT语句移到IF分支外面，不管booktitle是否为空，都返回结构一致的结果集（空结果或者匹配的数据）：

delimiter $
create procedure getbooksbytitle(booktitle char(200))
BEGIN
  DECLARE searchterm CHAR(201);
  set searchterm = "%";
  IF CHAR_LENGTH(booktitle) > 0 THEN
    set searchterm = concat(booktitle,'%');
  END IF;
  -- 不管条件是否满足，都执行查询，返回固定结构的结果集
  SELECT gb.book_id, gb.title,gb.isbn,gb.isbn13,gb.pubyear,gp.pubname 
  FROM grbooks gb 
  JOIN grpublishers gp ON (gp.publisher_id=gb.publisher_id) 
  WHERE gb.title LIKE searchterm;
END $
delimiter ;

这样无论输入是否为空，存储过程都会返回6个字段的结果集，bind_result就能正常匹配了。

方案2：在PHP代码中先检查结果集是否存在

如果不想改存储过程，可以在执行bind_result前先判断是否有结果集返回：

$query1->execute();
// 先存储结果集，判断是否存在
if ($query1->store_result()) {
    $query1->bind_result($book_id, $title, $isbn, $isbn13, $pubyear, $pubname);
    while($query1->fetch()) {
        // 注意这里有个拼写错误：searh → search
        echo '<a href="search/bookinfo/' . $book_id . '">' . $title . '</a><br />';
        echo $pubyear . '<br />';
        echo $pubname . '<br />';
        echo $isbn . '<br />';
        echo $isbn13 . '<br />';
    }
    $query1->free_result();
} else {
    echo "No books found matching your search criteria.";
}

另外提一句，你的代码里有个拼写错误：searh/bookinfo/应该改成search/bookinfo/，不然跳转链接会失效。

额外建议 #

记得对用户输入做基础校验，比如在获取$_POST['title']后，先判断是否为空或者过滤掉非法字符，避免不必要的空查询。不过你已经用了预处理语句绑定参数，这部分的SQL注入风险已经被规避了，这点做得不错👍

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