WooCommerce自定义结账字段无法存储及校验失败问题

按优先级从高到低排查，90%以上的同类问题都能在前三步定位根因：

• 先确认字段位置是否正确
  打开浏览器按F12调出开发者工具，在元素面板定位你添加的自定义输入框，向上追溯DOM节点，确认输入框是否在name="checkout"的<form>标签内部。Divi这类可视化编辑主题经常会把用户手动插入的代码块放到结账表单外部，这种情况下无论手动输入还是JS填充值，提交表单时字段数据根本不会被带入POST请求，自然读不到值，把字段挪到表单内部即可解决。
• 排查POST参数拦截问题
  临时关停所有安全插件（比如Wordfence、iThemes Security），联系主机商临时关闭WAF网页应用防火墙规则后再测试。不少主机默认的ModSecurity规则、安全插件的POST过滤逻辑，会直接拦截不在WooCommerce默认字段白名单内的自定义参数，导致PHP端读取$_POST时对应字段为空。如果确认是拦截问题，把你的自定义字段名加入规则白名单即可。
• 替换为高版本WooCommerce兼容代码
  你使用的旧版官方示例是针对WooCommerce 3.x版本编写的，在8.0+高版本中存在兼容问题，优先使用官方推荐的过滤器方式注册字段，系统会自动处理值读取、校验、存储全流程，不需要手动编写校验、存值逻辑，可替换为以下代码测试：

/**
 * 注册结账页自定义字段（适配WooCommerce 8.0+版本）
 */
add_filter( 'woocommerce_checkout_fields', 'custom_add_wallet_checkout_fields' );
function custom_add_wallet_checkout_fields( $fields ) {
    $fields['order']['checkbox_address'] = array(
        'type'          => 'checkbox',
        'class'         => array('my-field-class form-row-wide'),
        'label'         => __('我有加密钱包'),
        'required'      => false,
    );
    $fields['order']['address_field'] = array(
        'type'          => 'text',
        'class'         => array('my-field-class form-row-wide'),
        'label'         => __('钱包地址'),
        'placeholder'   => __('000'),
        'required'      => false,
    );
    $fields['order']['chosen_images'] = array(
        'type'          => 'textarea',
        'class'         => array('my-field-class form-row-wide'),
        'label'         => __('上方选择的NFT'),
        'required'      => true,
    );
    return $fields;
}

/**
 * 后台订单详情页显示自定义字段值
 */
add_action( 'woocommerce_admin_order_data_after_billing_address', 'custom_display_order_meta_in_admin', 10, 1 );
function custom_display_order_meta_in_admin($order){
    echo '<p><strong>所选NFT：</strong> ' . $order->get_meta( 'chosen_images', true ) . '</p>';
    echo '<p><strong>钱包地址：</strong> ' . $order->get_meta( 'address_field', true ) . '</p>';
}

• 排查Divi主题兼容问题
  临时切换到WordPress官方默认主题（比如Twenty Twenty-Four）测试提交，如果默认主题下字段值可以正常保存，说明是Divi主题的优化功能拦截了自定义字段，去Divi主题设置里关闭「结账页优化」「脚本延迟加载」类功能，把结账页加入缓存、优化排除列表即可。
• 抓包确认参数提交状态
  打开开发者工具切到网络面板，提交结账表单时找到checkout的POST请求，查看请求载荷中是否包含你的自定义字段参数：
  • 如果载荷中没有对应参数，回到第一步检查字段位置，排查是否有前端JS阻止了字段提交
  • 如果载荷中存在对应参数但PHP端读取为空，回到第二步排查WAF、安全插件、主题代码的参数过滤逻辑

测试前请清空页面缓存插件缓存、WooCommerce会话缓存，避免缓存逻辑干扰测试结果。

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