本文详解如何在wordpress商品保存时安全添加或更新自定义元字段（如main_reward、sub_reward），通过使用`save_post_product`钩子、校验autosave及改用`update_post_meta`，彻底解决元数据重复插入问题。
在WordPress开发中，使用save_post钩子处理商品元数据保存时，常遇到元字段被重复写入（如预期2条却生成4条）的问题。根本原因有三：
- save_post是全局钩子，会在所有文章类型保存时触发（包括修订版本、自动草稿等），导致函数被多次执行；
- 未排除自动保存（autosave）流程，而WordPress后台编辑器会频繁触发DOING_AUTOSAVE；
- 误用add_post_meta()——该函数不检查键是否存在，每次调用均新增一条记录，造成冗余。
✅ 正确做法是：
- 使用特定类型钩子 save_post_product，精准匹配商品（product）保存事件；
- 严格校验DOING_AUTOSAVE，避免自动保存流程干扰；
- 优先采用update_post_meta()替代add_post_meta()：它自动判断键是否存在，存在则更新，不存在则新增，天然幂等；
- 直接读取$_POST原始值（如$_POST[‘_regular_price’]），而非依赖已初始化的WC_Product对象——因save_post触发时，商品对象可能尚未完全持久化，其get_regular_price()返回旧值或缓存值，导致数据不同步。
以下是推荐的健壮实现：
add_action( 'save_post_product', 'so71077799_add_rewards', 99, 1 );
function so71077799_add_rewards( $product_id ) {
// 阻止自动保存、AJAX保存、批量操作等非手动提交场景
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
if ( defined( 'DOING_AJAX' ) && DOING_AJAX ) {
return;
}
if ( defined( 'DOING_CRON' ) && DOING_CRON ) {
return;
}
// 确保当前用户有编辑权限（可选但强烈建议）
if ( ! current_user_can( 'edit_post', $product_id ) ) {
return;
}
// 安全获取并格式化价格数据（保留两位小数）
$reg_price = isset( $_POST['_regular_price'] )
? number_format( floatval( $_POST['_regular_price'] ), 2, '.', '' )
: '0.00';
$sal_price = isset( $_POST['_sale_price'] )
? number_format( floatval( $_POST['_sale_price'] ), 2, '.', '' )
: '0.00';
// 使用 update_post_meta 实现“存在即更新，不存在即添加”
update_post_meta( $product_id, 'main_reward', $reg_price );
update_post_meta( $product_id, 'sub_reward', $sal_price );
}
? 关键注意事项：
- 钩子优先级设为99：确保在WooCommerce及其他插件的保存逻辑之后执行，避免被覆盖；
- 不要在函数内调用wc_get_product()再取价格：save_post触发时机早于数据库最终写入，此时$product->get_regular_price()可能仍为旧值；
- 始终校验$_POST键是否存在：防止未设置价格字段时传入空值或null；
- 若需兼容多货币或复杂定价逻辑，建议进一步校验$_POST[‘_price_type’]等上下文字段。
通过以上优化，你的main_reward和sub_reward元字段将严格保持唯一性，每次保存仅生成/更新各1条记录，彻底消除重复数据隐患。