保存产品技巧：防自定义字段重复保存

从现在开始，努力学习吧！本文《save_post_product 使用技巧：防止自定义字段重复保存》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

本文详解为何 `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 与权限。

通过以上重构，每次商品保存仅生成且仅更新两条元数据，彻底解决重复问题，同时提升代码健壮性与可维护性。

好了，本文到此结束，带大家了解了《保存产品技巧：防自定义字段重复保存》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！