ACF字段在WooCommerce结账页无法保存值至订单的问题排查

核心问题定位 #

硬编码值能正常保存，说明update_field逻辑本身没问题，问题出在无法正确获取用户提交的POST参数，或参数被WooCommerce过滤。以下是具体排查和解决步骤：

1. 确认ACF字段的POST键名 #

acf_form生成的字段，表单name属性并非直接使用字段别名（如inseam），而是会使用ACF字段的原始ID（格式为field_xxxxxx）。你可以通过浏览器开发者工具（F12）查看字段的name属性，比如会显示acf[field_123456]而非acf[inseam]。

解决代码： #

add_action( 'woocommerce_after_order_notes', 'my_acf_checkout_display' ); 
function my_acf_checkout_display() { 
    acf_form(array('form' => false,'fields' => array('inseam'))); 
}

add_action( 'woocommerce_checkout_update_order_meta','acf_update_field_at_checkout' ); 
function acf_update_field_at_checkout( $order_id ) { 
    // 先打印POST的ACF数据到日志，确认实际键名（测试完成后删除）
    error_log( print_r( $_POST['acf'], true ) );
    
    // 替换为你的字段真实ID（如field_xxxxxx）
    $my_field_key = 'field_xxxxxx';
    
    if( isset( $_POST['acf'][$my_field_key] ) ){
        update_field( $my_field_key, $_POST['acf'][$my_field_key], $order_id );
    }
}

2. 允许WooCommerce接收自定义ACF字段 #

WooCommerce结账表单会过滤非默认字段，需将ACF字段加入白名单：

add_filter( 'woocommerce_checkout_posted_data', 'whitelist_acf_checkout_field' );
function whitelist_acf_checkout_field( $posted_data ) {
    $my_field_key = 'field_xxxxxx';
    if( isset( $_POST['acf'][$my_field_key] ) ){
        $posted_data['acf'][$my_field_key] = $_POST['acf'][$my_field_key];
    }
    return $posted_data;
}

3. 改用ACF原生钩子处理保存 #

替代woocommerce_checkout_update_order_meta，使用ACF自带的acf/save_post钩子，兼容性更好：

add_action( 'woocommerce_after_order_notes', 'my_acf_checkout_display' ); 
function my_acf_checkout_display() { 
    acf_form(array(
        'form' => false,
        'fields' => array('inseam'),
        'post_id' => 'new_post' // 指定为新订单上下文
    )); 
}

add_action( 'acf/save_post', 'save_acf_field_to_order', 20 );
function save_acf_field_to_order( $post_id ) {
    // 仅处理订单类型
    if( get_post_type( $post_id ) !== 'shop_order' ) return;
    
    $my_field_key = 'field_xxxxxx';
    if( isset( $_POST['acf'][$my_field_key] ) ){
        update_field( $my_field_key, $_POST['acf'][$my_field_key], $post_id );
    }
}

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