通过自定义SQL更新WooCommerce产品自定义元数据异常求助

我维护着一个包含产品和产品捆绑包的WooCommerce店铺，想要在捆绑包的子产品上展示捆绑包的名称和价格。我用JetEngine创建了两个自定义字段，写了PHP代码从数据库获取子产品关联的捆绑包ID，再通过SQL更新这两个自定义字段的元值。调试日志显示所有数据都正确，但更新自定义字段没效果；如果把meta_key改成WooCommerce原生字段（比如_price），更新语句就能正常执行。想知道是不是不允许用SQL写入自定义字段，还是代码有问题，求解决方案。

代码如下：

function populate_bundle_data($post_id) {
    global $wpdb;

    $product = wc_get_product($post_id);

    // Retrieve the bundle ID
    $bundle_id = $wpdb->get_var($wpdb->prepare("
        SELECT bundle_id
        FROM {$wpdb->prefix}woocommerce_bundled_items
        WHERE product_id = %d
    ", $post_id));

    // Debug statement to check the retrieved bundle ID
    error_log('Bundle ID: ' . $bundle_id);

    if ($bundle_id && $product->is_type('simple')) {
        $bundle_product = wc_get_product($bundle_id);
        $bundle_name = $bundle_product->get_name();
        $bundle_price = $bundle_product->get_price();

        // Debug statements to check the bundle name and price
        error_log('Bundle Name: ' . $bundle_name);
        error_log('Bundle Price: ' . $bundle_price);
        
        error_log('Product id: ' . $post_id);

        // Update the JetEngine custom fields with bundle name and price
        
         $wpdb->query($wpdb->prepare("
            UPDATE {$wpdb->prefix}postmeta
            SET meta_value = %s
            WHERE post_id = %d
            AND meta_key = 'bundle-name'
        ", $bundle_name, $post_id));

        $wpdb->query($wpdb->prepare("
            UPDATE {$wpdb->prefix}postmeta
            SET meta_value = %s
            WHERE post_id = %d
            AND meta_key = 'bundle-price'
        ", $bundle_price, $post_id));

        // Debug statement to check if custom fields are updated
        error_log('Custom fields updated.');
    }
}

add_action('save_post_product', 'populate_bundle_data');

调试日志示例：

[13-Jul-2023 11:23:46 UTC] Bundle Name: Product bundle
[13-Jul-2023 11:23:46 UTC] Bundle Price: 200
[13-Jul-2023 11:23:46 UTC] Product id: 20
[13-Jul-2023 11:23:46 UTC] Custom fields updated. 

核心问题：直接SQL操作的局限性 #

JetEngine的自定义字段可能存在额外的存储逻辑（比如元数据验证、缓存机制，或者插件对字段名的特殊处理），直接用UPDATE语句修改postmeta表，既不会触发JetEngine需要的钩子/缓存更新，也无法在字段不存在时自动创建元数据记录——这就是你看到调试日志正常但字段无变化的原因。而WooCommerce原生字段能正常更新，是因为它们的元数据记录本身已经存在，且没有插件额外的拦截逻辑。

修正方案：改用WordPress官方函数替代SQL #

用WordPress原生的update_post_meta()函数，它会自动处理元数据的创建/更新，同时触发必要的钩子，完美兼容JetEngine这类插件：

function populate_bundle_data($post_id) {
    // 跳过自动保存和修订版本，避免重复执行
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    if (wp_is_post_revision($post_id)) return;
    // 权限检查，确保操作合法
    if (!current_user_can('edit_post', $post_id)) return;

    global $wpdb;
    $product = wc_get_product($post_id);

    // 获取捆绑包ID
    $bundle_id = $wpdb->get_var($wpdb->prepare("
        SELECT bundle_id
        FROM {$wpdb->prefix}woocommerce_bundled_items
        WHERE product_id = %d
    ", $post_id));

    error_log('Bundle ID: ' . $bundle_id);

    if ($bundle_id && $product->is_type('simple')) {
        $bundle_product = wc_get_product($bundle_id);
        $bundle_name = $bundle_product->get_name();
        $bundle_price = $bundle_product->get_price();

        error_log('Bundle Name: ' . $bundle_name);
        error_log('Bundle Price: ' . $bundle_price);
        error_log('Product id: ' . $post_id);

        // 使用官方函数更新自定义字段
        update_post_meta($post_id, 'bundle-name', $bundle_name);
        update_post_meta($post_id, 'bundle-price', $bundle_price);

        error_log('Custom fields updated via update_post_meta.');
    }
}
add_action('save_post_product', 'populate_bundle_data');

额外排查/优化建议 #

1. 确认字段名准确性：直接去wp_postmeta表查询，或者在JetEngine字段设置里核对——部分插件会给自定义字段名加前缀（比如jet_bundle-name），如果字段名不匹配，更新肯定无效。
2. 清理缓存：更新后如果前端没显示，手动清理WooCommerce缓存和JetEngine的缓存，确保新的元数据被读取。
3. 处理多捆绑包场景：如果一个子产品属于多个捆绑包，当前代码只会取第一个结果，可根据业务需求调整逻辑（比如存储所有捆绑包信息，或者筛选特定捆绑包）。

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