本文详解为何 `save_post` 导致元数据重复写入，并提供基于 `save_post_product` + `update_post_meta` 的健壮解决方案，包含防 autosave、类型校验与价格格式化处理。
在 WordPress 插件或主题开发中，为商品（product）保存时自动同步价格至自定义字段（如 main_reward 和 sub_reward）是常见需求。但若直接使用通用钩子 save_post 并配合 add_post_meta()，极易引发元数据重复写入问题——例如本例中预期存 2 条记录，实际却生成 4 条甚至更多。
根本原因有三：
✅ 钩子范围过宽：save_post 在所有文章类型（post、page、product、revision 等）保存时均触发，而 WooCommerce 商品编辑页常伴随草稿、修订版、AJAX 自动保存等多次调用；
✅ 未过滤 autosave：WordPress 后台默认启用自动保存（autosave），若不拦截 DOING_AUTOSAVE，每次光标离开输入框都可能触发一次元数据写入；
✅ 误用 add_post_meta()：该函数无去重逻辑，只要传入的 $meta_key 不存在即新增，存在则继续追加同名新记录（而非更新），导致历史冗余。
✅ 正确实践：精准钩子 + 安全更新 + 数据校验
应改用类型专属钩子 save_post_product，并始终优先使用 update_post_meta() —— 它具备智能行为：若键已存在则更新值，否则自动创建，天然避免重复。
以下是优化后的完整代码（已适配 WooCommerce 8.x+ 及 PHP 8.0+）：
add_action( 'save_post_product', 'so71077799_add_rewards', 99, 1 );
function so71077799_add_rewards( $product_id ) {
// 1️⃣ 阻止自动保存干扰
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
// 2️⃣ 验证当前用户权限（可选但强烈推荐）
if ( ! current_user_can( 'edit_post', $product_id ) ) {
return;
}
// 3️⃣ 从 $_POST 安全读取原始价格（比 get_regular_price() 更可靠，因后者依赖对象状态）
$regular_price = isset( $_POST['_regular_price'] ) ? wc_clean( wp_unslash( $_POST['_regular_price'] ) ) : '';
$sale_price = isset( $_POST['_sale_price'] ) ? wc_clean( wp_unslash( $_POST['_sale_price'] ) ) : '';
// 4️⃣ 格式化并写入元字段（保留两位小数，兼容货币显示）
if ( is_numeric( $regular_price ) && $regular_price !== '' ) {
update_post_meta( $product_id, 'main_reward', number_format( floatval( $regular_price ), 2, '.', '' ) );
}
if ( is_numeric( $sale_price ) && $sale_price !== '' ) {
update_post_meta( $product_id, 'sub_reward', number_format( floatval( $sale_price ), 2, '.', '' ) );
}
}
? 关键要点说明
- 钩子优先级设为 99：确保在 WooCommerce 自身保存逻辑之后执行，避免被覆盖；
- wc_clean() + wp_unslash() 组合：防御 XSS 与转义字符风险，符合 WooCommerce 安全规范；
- 显式 is_numeric() 校验：防止空字符串、非数字输入污染数据库；
- number_format(…, 2, ‘.’, ”)：统一小数位数，避免浮点精度差异（如 19.9 → 19.90），便于前端展示与计算；
- 无需 global $WCFM, $WCFMmp：本逻辑独立于 WCFM 插件，移除可提升兼容性与性能。
⚠️ 注意：若需兼容 WCFM 多供应商环境，请额外校验 $_POST[‘wcfm_product_options’] 或监听 wcfm_product_updated 钩子，但核心原则不变——用 save_post_{post_type} 替代通用钩子，用 update_post_meta 替代 add_post_meta，永远校验 autosave 与权限。
通过以上重构，每次商品保存仅生成且仅更新两条元数据，彻底解决重复问题，同时提升代码健壮性与可维护性。