现象:exeCute 一调用就抛 HY093
用 PDO 执行预处理语句,参数绑完调用 execute(),直接抛出 SQLSTATE[HY093]: Invalid parameter number: number of bound variables does not match number of tokens。SQL 本身能跑,参数也是表单里拿的正常值,就是执行不过去,日志里也看不出是哪一列出的问题。
原因:占位符和绑定值对不上
- SQL 里有 3 个占位符,只绑了 2 个,或者多绑了一个;
- 命名占位符
:id在语句里出现两次,却只绑定一次; - 同一个语句里混用
?和:name,驱动无法对应; - 把整个数组当成一个值绑进去,一个参数膨胀成多个 token;
- 用了
:name却按位置传数组,或者反过来用?却按名字绑定。
解决步骤
第一步,先数占位符。命名占位符重复出现时,在模拟预处理模式下可以只绑一次,但关掉模拟后必须按出现次数绑定,最稳的写法是改成两个不同名字:
$sql = 'SELECT * FROM user WHERE id = :id OR parent_id = :pid';
$st = $pdo->prepare($sql);
$st->bindValue(':id', $id, PDO::PARAM_INT);
$st->bindValue(':pid', $id, PDO::PARAM_INT);
$st->execute();
第二步,显式指定类型。字符串型参数不写类型时,驱动按字符串处理,遇到 LIMIT 后面的数字会直接报语法错误,顺手一起改掉:
$st->bindValue(':name', $name, PDO::PARAM_STR);
$st->bindValue(':age', (int)$age, PDO::PARAM_INT);
第三步,用问号占位符时严格按顺序传数组。键必须是 0 起始的连续整数,用字符串键会被当成命名参数,立刻触发 HY093:
$st = $pdo->prepare('SELECT * FROM user WHERE id = ? AND status = ?');
$st->execute([$id, $status]);
第四步,把实际语句打出来核对。框架的查询构造器常常在前面拼了条件,占位符数量已经变了。打开 ATTR_EMULATE_PREPARES 前后各跑一次,能快速判断是绑定问题还是 SQL 拼接问题。
还有一个高频细节:用 execute() 传关联数组时,键名必须带冒号,['id' => 1] 会被当成位置参数而报错,必须写成 [':id' => 1]。另外,占位符只能出现在值的位置,把表名或字段名写成 :table 同样触发 HY093,这类动态标识符要先用白名单校验再拼进 SQL。
小结
HY093 和业务数据无关,纯粹是数量或命名没对齐。数占位符、统一命名风格、显式绑定类型,三步能覆盖绝大多数场景。
