WooCommerce按国家修改结账与我的账户地址字段失效问题排查

我用以下代码修改结账地址字段，适配不同国家的地址格式，其他国家的修改都生效，但英国（GB）和新西兰（NZ）的州/省字段改不动：英国的“County（可选）”标签没变化，新西兰的“Region（可选）”仍为下拉列表且标签未变。怀疑是WooCommerce核心JavaScript覆盖了设置，求解决思路？

用户提供的代码 #

function modify_default_address_fields($address_fields) {
    if ( function_exists('WC') && WC()->customer && ( is_checkout() || is_account_page() ) ) {
        $country = WC()->customer->get_billing_country();

        // Taiwan
        if ($country === 'TW') {
            $address_fields['city']['label'] = 'District';
            $address_fields['state']['label'] = 'City';
        }

        // Hong Kong
        if ($country === 'HK') {
            $address_fields['address_1']['label'] = 'Flat/Unit, Floor, Building, Street';
            $address_fields['city']['label'] = 'District';
            unset($address_fields['postcode']);
        }

        // Germany
        if ($country === 'DE') {
            unset($address_fields['state']);
        }
        
        // UK
        if ($country === 'GB') {
            $address_fields['city']['label'] = 'Locality / Village name (optional)';
            $address_fields['state']['required'] = true;
            $address_fields['state']['label'] = 'Town / City';
        }

        // New Zealand
        if ($country === 'NZ') {
            $address_fields['city']['label'] = 'Suburb';
            $address_fields['state']['required'] = true;
            $address_fields['state']['label'] = 'Town / City';
            $address_fields['state']['type'] = 'text';
        }

    }
    return $address_fields;
}
// Make sure all systems are loaded before executing the function (prevent fatal error)
function initialize_address_field_modifications() {
    add_filter('woocommerce_default_address_fields', 'modify_default_address_fields', 9999);
}
add_action('init', 'initialize_address_field_modifications');

解决思路 #

1. 核心原因：WooCommerce对特定国家有预设地址规则 #

英国（GB）、新西兰（NZ）这类国家，WooCommerce内置了州/省的预设选项（比如GB的County、NZ的Region），并且会通过前端JS动态渲染地址字段，仅修改woocommerce_default_address_fields无法覆盖这些预设规则，需要针对性处理：

2. 针对新西兰（NZ）：清空预设州选项，强制使用文本字段 #

NZ的Region是预设下拉列表，必须先清空它的预设数据，WooCommerce才会使用你设置的文本字段：

add_filter('woocommerce_states', 'modify_nz_states', 9999);
function modify_nz_states($states) {
    $states['NZ'] = array(); // 清空预设的Region选项
    return $states;
}

3. 用woocommerce_get_country_locale覆盖国家地址规则 #

这个过滤器是WooCommerce定义各国地址字段规则的核心，优先级高于woocommerce_default_address_fields，且前端JS切换国家时会读取这里的配置，专门用来解决GB/NZ这类有预设规则的国家：

add_filter('woocommerce_get_country_locale', 'modify_gb_nz_locale', 9999);
function modify_gb_nz_locale($locale) {
    // 英国GB配置
    $locale['GB']['state']['label'] = 'Town / City';
    $locale['GB']['state']['required'] = true;
    $locale['GB']['city']['label'] = 'Locality / Village name (optional)';
    
    // 新西兰NZ配置
    $locale['NZ']['state']['label'] = 'Town / City';
    $locale['NZ']['state']['required'] = true;
    $locale['NZ']['state']['type'] = 'text'; // 强制设为文本字段
    $locale['NZ']['city']['label'] = 'Suburb';
    
    return $locale;
}

4. 修复原代码的逻辑问题 #

• 原代码通过WC()->customer->get_billing_country()仅获取用户当前的账单国家，无法应对用户切换国家的动态场景，建议移除该判断，让过滤器全局生效，或者通过woocommerce_get_country_locale按国家配置更可靠。
• 原代码用init钩子加载过滤器过早，换成woocommerce_init钩子，确保WooCommerce完全加载后再执行：

function initialize_address_field_modifications() {
    add_filter('woocommerce_default_address_fields', 'modify_default_address_fields', 9999);
    add_filter('woocommerce_states', 'modify_nz_states', 9999);
    add_filter('woocommerce_get_country_locale', 'modify_gb_nz_locale', 9999);
}
add_action('woocommerce_init', 'initialize_address_field_modifications');

5. 强制刷新前端JS缓存 #

如果修改后还是不生效，可能是浏览器缓存了WooCommerce的地址JS文件，加这段代码强制刷新：

add_filter('script_loader_src', 'refresh_woocommerce_address_js', 9999);
function refresh_woocommerce_address_js($src) {
    if (strpos($src, 'woocommerce/assets/js/frontend/address-i18n.js') !== false) {
        $src = add_query_arg('v', time(), $src);
    }
    return $src;
}

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