WooCommerce后台产品属性自定义字段值无法保存问题排查

你的代码存在几个关键问题，导致自定义字段值无法保存：

1. 钩子注册时机错误 #

当前代码依赖页面$_GET参数注册钩子，但WordPress处理术语保存请求时，不一定携带相同的$_GET参数，导致created_{taxonomy}和edited_{taxonomy}这两个保存相关的钩子未被正确注册，保存函数无法触发。

正确做法是将钩子注册放到admin_init动作中，确保后台初始化阶段就完成钩子绑定，不依赖当前页面的请求参数。

2. 未校验POST参数存在性 #

保存函数直接调用$_POST['custom-term-input']，如果该参数不存在（比如页面刷新、非目标请求），会触发PHP警告，同时导致update_term_meta执行异常。

修复后的代码 #

add_action('admin_init', 'register_product_taxonomy_custom_fields');

function register_product_taxonomy_custom_fields() {
    // 获取所有产品关联的分类法
    $product_taxonomies = get_object_taxonomies('product', 'names');
    foreach ($product_taxonomies as $taxonomy) {
        // 仅针对WooCommerce产品属性（分类法ID以pa_开头）
        if (str_starts_with($taxonomy, 'pa_')) {
            add_action("{$taxonomy}_edit_form_fields", 'custom_edit_term_fields', 10, 2);
            add_action("created_{$taxonomy}", 'custom_save_term_fields');
            add_action("edited_{$taxonomy}", 'custom_save_term_fields');
        }
    }
}

function custom_edit_term_fields($term, $taxonomy) {
    $value = get_term_meta($term->term_id, 'custom-term-input', true);
    ?>
    <tr class="form-field">
        <th>
            <label for="custom-term-input">Custom input</label>
        </th>
        <td>
            <input name="custom-term-input" id="custom-term-input" type="text" value="<?php echo esc_attr($value); ?>" />
            <p class="description">Description text</p>
        </td>
    </tr>
    <?php
}

function custom_save_term_fields($term_id) {
    // 校验POST参数是否存在
    if (!isset($_POST['custom-term-input'])) {
        return;
    }
    update_term_meta(
        $term_id,
        'custom-term-input',
        sanitize_text_field($_POST['custom-term-input'])
    );
}

额外说明 #

• 通过admin_init统一注册所有产品属性分类法的钩子，确保保存动作触发时钩子已生效。
• 保留str_starts_with($taxonomy, 'pa_')判断，只针对WooCommerce原生产品属性分类法，若需给所有产品关联分类法添加字段，可删除此判断。
• 保存函数增加参数校验，避免无意义的错误触发。

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