WooCommerce自动分配商品分类失效求助：基于ACF自定义字段值

先帮你梳理下原代码里的几个关键问题，然后给出可行的修正方案：

原代码的核心问题 #

• 变量混乱：函数参数是$product_id，但里面误用了未定义的$post_id和$post->ID，导致无法正确获取商品ID
• 钩子时机不对：save_post钩子会在ACF字段还没完成保存时就触发，这时候get_field("city")可能拿不到最新值
• 逻辑漏洞：循环商品分类后直接break，只检查第一个分类；而且重复执行wp_set_post_terms的逻辑有问题，可能导致分类被错误覆盖或重复添加
• 缺少权限验证：没有检查当前用户是否有编辑商品的权限，可能触发不必要的操作

修正后的可行方案 #

推荐使用ACF自带的acf/save_post钩子（优先级设为20，确保字段已保存），或者WooCommerce专属的woocommerce_save_product钩子，下面是具体代码：

方案一：使用ACF专属钩子（更可靠） #

function auto_assign_product_category_by_acf($post_id) {
    // 仅处理商品类型，且用户有编辑权限
    if (get_post_type($post_id) !== 'product' || !current_user_can('edit_post', $post_id)) {
        return;
    }

    // 获取ACF字段值（确保字段已保存）
    $city_value = get_field('city', $post_id);
    $target_category_id = 93; // 目标分类ID

    // 检查字段值是否匹配
    if ($city_value === 'Cassis') {
        // 先检查商品是否已拥有该分类，避免重复添加
        $existing_categories = wp_get_post_terms($post_id, 'product_cat', array('fields' => 'ids'));
        
        if (!in_array($target_category_id, $existing_categories)) {
            // 添加分类（第三个参数true表示追加，不覆盖现有分类）
            wp_set_post_terms($post_id, $target_category_id, 'product_cat', true);
        }
    }
}
// 优先级设为20，确保ACF字段已完成保存
add_action('acf/save_post', 'auto_assign_product_category_by_acf', 20);

方案二：使用WooCommerce商品保存钩子 #

function auto_assign_product_category_on_save($product_id, $product) {
    // 跳过自动保存和草稿
    if (wp_is_post_autosave($product_id) || wp_is_post_revision($product_id)) {
        return;
    }

    // 获取ACF字段值
    $city_value = get_field('city', $product_id);
    $target_category_id = 93;

    if ($city_value === 'Cassis') {
        $existing_cats = $product->get_category_ids();
        if (!in_array($target_category_id, $existing_cats)) {
            $product->set_category_ids(array_merge($existing_cats, array($target_category_id)));
            $product->save();
        }
    }
}
add_action('woocommerce_save_product', 'auto_assign_product_category_on_save', 10, 2);

关键优化点说明 #

• 钩子时机：acf/save_post优先级20确保ACF字段已经写入数据库，避免拿不到最新值
• 权限与类型校验：过滤非商品类型和无权限操作，避免错误触发
• 重复添加检查：先获取现有分类ID，确认目标分类不存在时再添加，避免冗余操作
• WooCommerce对象用法：方案二中直接使用WooCommerce的WC_Product对象方法，更符合WooCommerce的开发规范

测试步骤 #

1. 将代码添加到主题的functions.php文件，或者使用代码片段插件（推荐，避免主题更新丢失）
2. 编辑一个商品，设置city字段为Cassis并保存
3. 查看商品的分类，确认已自动添加ID为93的分类
4. 再次保存该商品，不会重复添加分类（因为做了存在性检查）

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