本文详解如何在 woocommerce 中根据 `old_id` 自定义字段值精准查询对应的产品分类（product_cat）id，纠正 `get_categories()` 不适用及 `wp_query` 误用的问题，提供正确、高效、可复用的 `get_terms()` 解决方案。

WooCommerce 的产品分类（Product Categories）本质上是自定义分类法（taxonomy）product_cat，而非 WordPress 默认的 category。因此，不能使用 get_categories()（该函数仅支持内置分类法），也不能在 WP_Query 中对分类本身进行元字段查询——因为 tax_query 用于筛选“属于某分类的文章”，而非“按元数据查找分类项”。

正确的方式是使用 WordPress 核心函数 get_terms()，并显式指定 'taxonomy' => 'product_cat'，同时利用其原生支持的 meta_key 和 meta_value 参数（注意：这是 get_terms() 自 4.6+ 起支持的简写形式，比嵌套 meta_query 更简洁可靠）：

图片转Word

将扫描图像、截图或表单、文档及以文字为主的图片内容，转换为可编辑的 Word（.docx）文件。 当用户提供包含文本内容的图片，并要求将其转为 Word 文档时，应使用此技能； 或用户表达类似“把图片搞成 word 文字版”、“convert image to docx”、“extract text from image to Word”等需求时，也应调用此技能。

下载

function wc_get_product_category_by_old_id( $old_cat_id ) {
    $terms = get_terms(
        array(
            'taxonomy'   => 'product_cat',
            'meta_key'   => 'old_id',
            'meta_value' => $old_cat_id,
            'hide_empty' => false,
            'number'     => 1, // 确保最多返回一个（避免重复 old_id 导致歧义）
            'fields'     => 'ids', // 直接返回 ID 数组，轻量高效
        )
    );

    // 检查是否出错或无结果
    if ( is_wp_error( $terms ) || empty( $terms ) ) {
        return 0;
    }

    return (int) $terms[0];
}

// 使用示例：
$old_id = 123;
$new_cat_id = wc_get_product_category_by_old_id( $old_id );
if ( $new_cat_id ) {
    echo "新分类 ID 为：{$new_cat_id}";
} else {
    echo "未找到匹配的分类（old_id = {$old_id}）";
}

✅ 关键要点说明：

• ✅ 必须指定 'taxonomy' => 'product_cat'；否则 get_terms() 默认操作 category。
• ✅ meta_key + meta_value 是 get_terms() 的合法参数（无需复杂 meta_query 数组），语义清晰且兼容性好。
• ✅ 添加 'number' => 1 可防多匹配冗余，'fields' => 'ids' 避免加载完整对象，提升性能。
• ❌ WP_Query 的 tax_query 无法查询分类元数据——它只作用于文章与分类的关联关系。
• ❌ get_categories() 完全不支持自定义分类法，调用将静默失败或返回空数组。

? 进阶建议：
如需批量映射或迁移场景，可配合 wp_cache_set() 缓存结果，避免高频重复查询；若 old_id 存在重复，建议在数据库层面添加唯一索引约束，确保业务逻辑健壮性。