WooCommerce checkout_update_user_meta钩子失效，值交换无响应排查

下面是针对你代码问题的具体分析和可能原因：

1. 仅登录用户触发，访客结账不生效 #

woocommerce_checkout_update_user_meta 钩子只在登录用户完成结账时触发，如果访客结账（未登录创建新账户），$user_id 会是0，update_user_meta 对无效用户ID不会执行任何操作。

如果你需要覆盖访客创建账户的场景，应该改用 woocommerce_checkout_create_customer 钩子，在用户创建时就修改元数据：

function my_checkout_create_customer( $customer_id, $data, $args ) {
    if(pll_current_language() == 'he') {
        $first_name_input = isset($data['billing_first_name']) ? sanitize_text_field($data['billing_first_name']) : '';
        $billing_company_input = isset($data['billing_company']) ? sanitize_text_field($data['billing_company']) : '';
        update_user_meta( $customer_id, 'billing_address_2', $billing_company_input );
        update_user_meta( $customer_id, 'billing_company', $first_name_input );
    }
}
add_action( 'woocommerce_checkout_create_customer', 'my_checkout_create_customer', 10, 3 );

2. Polylang 语言检测时机不对 #

pll_current_language() 在 woocommerce_checkout_update_user_meta 钩子触发时，可能还未完成语言初始化，导致判断始终不成立。可以尝试：

• 直接打印当前语言值排查：在函数开头加 var_dump(pll_current_language()); die();，看输出是否为he
• 改用 pll_get_current_language()（Polylang 部分版本的正确函数）
• 检查语言代码是否正确，比如部分环境下希伯来语的代码是he_IL而非he

3. $_POST 字段未正确获取 #

结账流程中，某些场景（比如AJAX结账、主题/插件修改字段名）可能导致$_POST['billing_first_name']或$_POST['billing_company']不存在：

• 在函数内打印$_POST内容确认：var_dump($_POST); die();，检查目标字段是否存在
• 改用WooCommerce提供的WC()->checkout->get_posted_data()获取表单数据，比直接用$_POST更可靠：

$posted_data = WC()->checkout->get_posted_data();
$first_name_input = isset($posted_data['billing_first_name']) ? sanitize_text_field($posted_data['billing_first_name']) : '';
$billing_company_input = isset($posted_data['billing_company']) ? sanitize_text_field($posted_data['billing_company']) : '';

4. 钩子优先级冲突 #

如果其他插件/主题也使用了woocommerce_checkout_update_user_meta钩子，且优先级比你的默认10更高（数值更小），可能会覆盖你的修改。可以提高钩子优先级，确保你的代码最后执行：

add_action( 'woocommerce_checkout_update_user_meta', 'my_checkout_update_user_meta', 20 ); // 优先级20，晚于默认10

5. 用户元数据缓存未更新 #

WooCommerce和WordPress会缓存用户元数据，即使你的代码执行成功，前端可能也不会立刻显示更新结果。排查时可以：

• 直接查看数据库wp_usermeta表，确认对应user_id的billing_address_2和billing_company字段是否已更新
• 清除WordPress缓存、浏览器缓存后再查看

6. 函数未正确加载 #

检查你的代码是否放在正确位置（比如主题的functions.php文件、自定义插件），避免因文件未加载导致函数未注册。可以在函数开头加error_log('my function ran');，然后查看WordPress错误日志确认函数是否被触发。

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