执行UPDATE脚本遇SQLSTATE[HY093]错误：绑定变量与令牌数不匹配

这个错误本质就是SQL语句里的占位符数量/名称，和你绑定的变量数量/名称不匹配，咱们一步步拆解你的代码问题：

问题1：SQL占位符拼写错误 #

看你的UPDATE语句：

UPDATE clients SET firstname =:firsname, ... identity =:identiy, ... WHERE client_id=:id

这里有两个低级拼写失误：

• :firsname 少了字母t，应该写成:firstname（和你后面绑定的参数名称对应）
• :identiy 少了字母t，应该写成:identity（和你绑定的参数名称对应）

这两个错误会导致：你绑定了:firstname和:identity，但SQL里找不到这两个占位符；同时SQL里的:firsname和:identiy没有对应的绑定变量，直接触发参数不匹配。

问题2：遗漏了WHERE子句的占位符绑定 #

你的SQL最后有个WHERE client_id=:id，但你的代码里完全没有绑定:id这个参数，甚至update方法的参数列表里都没传入$id！这又是一个明显的参数不匹配点。

修正后的完整代码 #

public function update($id, $firstname, $lastname, $postaladdress, $mobilephone, $officephone, $personalemail, $officialemail, $nationality, $city, $identity, $id_number, $gender, $dob) {
    try {
        // 修正占位符拼写错误，确保和绑定名称完全一致
        $stmt=$this->db->prepare ("UPDATE clients SET 
            firstname =:firstname, 
            lastname =:lastname, 
            postaladdress =:postaladdress, 
            mobilephone =:mobilephone, 
            officephone =:officephone, 
            personalemail =:personalemail, 
            officialemail =:officialemail, 
            nationality =:nationality, 
            city =:city, 
            identity =:identity, 
            id_number =:id_number, 
            gender =:gender, 
            dob =:dob 
        WHERE client_id=:id");
        
        // 绑定所有占位符，包括新增的:id参数
        $stmt->bindparam(":id", $id);
        $stmt->bindparam(":firstname",$firstname);
        $stmt->bindparam(":lastname",$lastname);
        $stmt->bindparam(":postaladdress",$postaladdress);
        $stmt->bindparam(":mobilephone",$mobilephone);
        $stmt->bindparam(":officephone",$officephone);
        $stmt->bindparam(":personalemail",$personalemail);
        $stmt->bindparam(":officialemail",$officialemail);
        $stmt->bindparam(":nationality",$nationality);
        $stmt->bindparam(":city",$city);
        $stmt->bindparam(":identity",$identity);
        $stmt->bindparam(":id_number",$id_number);
        $stmt->bindparam(":gender",$gender);
        $stmt->bindparam(":dob",$dob);
        
        $stmt->execute();
        return true;
    } catch(PDOException $e) {
        echo $e->getMessage();
        return false;
    }
}

通用排查技巧 #

以后遇到这类错误，按这两步来快速定位：

1. 逐字核对占位符名称：把SQL里的每个:xxx和bindparam里的:xxx逐个对比，拼写、大小写（虽然PDO占位符大小写不敏感，但建议保持一致）都要完全匹配
2. 数清楚数量：统计SQL里的占位符总数，再数bindparam的调用次数，必须完全相等，别漏了WHERE子句里的占位符

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