WordPress通用增改函数报错：MySQL预处理语句解析问题

你的问题核心很明确：你把包含$wpdb->prepare的PHP代码当成字符串传给了$wpdb->query，但query方法只接受纯SQL语句。数据库根本不认识PHP代码，所以会把$wpdb->prepare(...)当成SQL的一部分，直接抛出语法错误。

为什么原来的写法会出错？ #

你构造的$update和$insert是字符串形式的PHP代码，比如：

$update = '$wpdb->prepare("UPDATE '. $dbTable. ' SET Distance = %d WHERE Date = %s AND UserID = %d", '. $distance. ', '. $today. ', '. $userID. ')';

这时候$update存储的是一段文本，而不是执行$wpdb->prepare后得到的SQL语句。当你把这个字符串传给$wpdb->query时，数据库会尝试执行这段文本，自然会报错——因为$wpdb->prepare不是合法的SQL语法。

修复方案1：先执行prepare，再传递SQL语句 #

首先修改外部调用代码，直接执行$wpdb->prepare得到预处理后的SQL，再传给你的函数：

// 正确生成预处理后的SQL语句，而不是存成PHP代码字符串
$update_sql = $wpdb->prepare(
    "UPDATE $dbTable SET Distance = %d WHERE Date = %s AND UserID = %d",
    $distance,
    $today,
    $userID
);
$insert_sql = $wpdb->prepare(
    "INSERT INTO $dbTable (Distance, Date, UserID) VALUES (%d,%s,%d)",
    $distance,
    $today,
    $userID
);

// 调用函数
hfwp_SaveFormData($update_sql, $insert_sql, $userID, $today, $dbTable);

然后修改你的hfwp_SaveFormData函数，去掉那些检查字符串内容的逻辑，直接执行传入的SQL：

function hfwp_SaveFormData($update_sql, $insert_sql, $userID, $today, $dbTable) {
    global $wpdb;
    $wpdb->show_errors();
    
    // 查询是否存在匹配记录（优化写法，避免不必要的全表计数）
    $count = $wpdb->get_var(
        $wpdb->prepare(
            "SELECT COUNT(*) FROM $dbTable WHERE Date = %s AND UserID = %d",
            $today,
            $userID
        )
    );
    
    if ($count > 0) {
        $wpdb->query($update_sql);
        if (!empty($wpdb->last_error)) {
            hfwp_Log_Errors($update_sql, $userID, $today, $wpdb->last_error);
        }
    } else {
        $wpdb->query($insert_sql);
        if (!empty($wpdb->last_error)) {
            hfwp_Log_Errors($insert_sql, $userID, $today, $wpdb->last_error);
        }
    }
}

修复方案2：使用WordPress内置的update/insert方法（更推荐） #

WordPress的$wpdb已经提供了更安全、更简洁的update和insert方法，它们内部自动处理了SQL预处理，不需要手动写prepare：

function hfwp_SaveFormData($distance, $userID, $today, $dbTable) {
    global $wpdb;
    $wpdb->show_errors();
    
    // 检查记录是否存在（用LIMIT 1优化查询效率，不需要统计全部数量）
    $record_exists = $wpdb->get_var(
        $wpdb->prepare(
            "SELECT 1 FROM $dbTable WHERE Date = %s AND UserID = %d LIMIT 1",
            $today,
            $userID
        )
    );
    
    if ($record_exists) {
        // 执行更新操作
        $update_result = $wpdb->update(
            $dbTable,
            ['Distance' => $distance], // 要更新的字段和值
            ['Date' => $today, 'UserID' => $userID], // WHERE条件
            ['%d'], // 更新字段的格式符（%d代表整数）
            ['%s', '%d'] // WHERE条件的格式符
        );
        
        if ($update_result === false) {
            hfwp_Log_Errors('Update failed', $userID, $today, $wpdb->last_error);
        }
    } else {
        // 执行插入操作
        $insert_result = $wpdb->insert(
            $dbTable,
            [
                'Distance' => $distance,
                'Date' => $today,
                'UserID' => $userID
            ],
            ['%d', '%s', '%d'] // 每个字段对应的格式符
        );
        
        if ($insert_result === false) {
            hfwp_Log_Errors('Insert failed', $userID, $today, $wpdb->last_error);
        }
    }
}

这种写法不仅更简洁，还避免了手动构造SQL可能出现的错误，安全性也更高。

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