如何在WooCommerce中以编程方式更新_wc_average_rating元字段

问题原因 #

你直接更新_wc_average_rating不生效的核心原因是WooCommerce对产品数据做了对象缓存，直接修改数据库的postmeta值后，系统读取的还是旧的缓存数据，所以看起来更新没有生效。此外直接操作postmeta属于底层修改，没有走WooCommerce官方的数据校验逻辑，容易出现兼容问题。

官方推荐解决方案 #

WooCommerce提供了标准化的产品CRUD方法来修改评分相关数据，会自动处理数据校验、元字段更新和缓存清空，代码示例如下：

// 获取目标产品对象
$product = wc_get_product( 13566 );
if ( $product ) {
    // 设置平均评分，可直接传浮点数
    $product->set_average_rating( 5.00 );
    // 设置各星级对应的评价数量，数组键为星级，值为对应评价数
    $product->set_rating_counts( [ 5 => 4 ] );
    // 设置总评价数
    $product->set_review_count( 4 );
    // 保存修改，自动同步所有元字段并清空相关缓存
    $product->save();
}

如果需要同步多个产品的评价数据，只需要循环产品ID列表，逐个执行上述逻辑即可。

如果你坚持直接操作元字段 #

可在更新完三个元字段后，手动添加清空产品缓存的代码，即可让更新生效：

update_post_meta( 13566, '_wc_review_count', 4);
update_post_meta( 13566, '_wc_rating_count', 4);
update_post_meta( 13566, '_wc_average_rating', 5.00);

// 清空产品相关 transient 缓存
wc_delete_product_transients( 13566 );
// 作废产品对象缓存组
WC_Cache_Helper::invalidate_cache_group( 'product_' . 13566 );

该方法不推荐长期使用，后续WooCommerce版本迭代如果调整了元字段存储逻辑或缓存机制，代码可能会失效。

内容的提问来源于stack exchange，提问作者Luuk Van Dongen