SQL LIKE与PDO bindParam报错SQLSTATE[HY093]：参数编号无效

这个错误我碰到过好多次，本质上就是你绑定的参数和SQL语句里的占位符完全不匹配——要么数量对不上，要么格式混用，要么拼接查询时不小心多出来/漏了占位符。结合你说的“不绑变量就正常”，肯定是绑定环节出了问题，我给你拆解几个常见坑和解决办法：

1. 别混用占位符格式 #

PDO支持两种占位符：?（索引式）和:name（命名式），但绝对不能在同一条SQL里混用！比如你写了：

SELECT * FROM table WHERE name LIKE ? AND age > :age

这种写法直接触发HY093错误，必须统一用一种格式。建议用命名式，可读性更高，也不容易搞混顺序。

2. 核对占位符和绑定参数的数量 #

最常见的情况是：

• SQL里有N个占位符，但你只绑定了N-1个参数；
• 或者你绑定了多余的参数，SQL里根本没对应的占位符。

举个例子，如果你想实现多字段搜索，写了：

SELECT * FROM users WHERE name LIKE :search OR email LIKE :search

这里有两个:search占位符，但PDO支持同名占位符复用，所以你只需要绑定一次就行：

$this->pdo->bindValue(':search', "%{$searchVal}%", PDO::PARAM_STR);

但如果你不小心写成了绑定两次，或者SQL里实际是:search1和:search2但只绑定了一个，就会报错。

3. 检查自定义类的查询拼接逻辑 #

你说添加搜索前一切正常，那大概率是拼接搜索条件时出了问题：

• 比如搜索条件为空时，你还是拼接了带占位符的WHERE子句，导致SQL里多了个:search但没绑定参数；
• 或者拼接时重复添加了占位符，比如循环拼接条件时每次都加了同一个占位符，但没对应绑定。

修复示例（假设你的类逻辑）：

// 初始化基础查询
$this->query = "SELECT * FROM your_table";
$params = [];

// 处理搜索条件：只有当搜索词存在时才拼接
if (!empty($searchTerm)) {
    $this->query .= " WHERE column1 LIKE :search OR column2 LIKE :search";
    $params[':search'] = "%{$searchTerm}%";
}

// 追加分页参数
$this->query .= " LIMIT :limit OFFSET :offset";
$params[':limit'] = $this->limit;
$params[':offset'] = $this->offset;

// 统一绑定参数
foreach ($params as $key => $value) {
    $this->pdo->bindValue($key, $value, is_int($value) ? PDO::PARAM_INT : PDO::PARAM_STR);
}

这种方式先把所有要绑定的参数存在数组里，最后统一绑定，能有效避免数量不匹配的问题。

4. 排查拼写和大小写问题 #

虽然大部分数据库驱动对命名占位符不区分大小写，但保险起见，要确保绑定的参数名和SQL里的占位符完全一致：比如SQL里是:searchTerm，绑定的时候别写成:searchterm。

快速排查技巧 #

把最终生成的SQL语句和绑定的参数都打印出来：

echo "最终SQL：" . $this->query . "<br>";
echo "绑定的参数：" . print_r($params, true);

一眼就能看出来哪里不匹配。

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