WooCommerce可变产品“Please choose product options”报错修复

这个错误本质是WooCommerce的加购校验逻辑判定：当前请求没有经过可变产品的属性选择流程，为了防止用户错拍直接拦截请求，按以下优先级从高到低排查即可解决：

一、优先排查前端资源/缓存问题（80%的这类问题出在这） #

• 全链路清缓存：清空站点缓存插件缓存、CDN缓存、浏览器本地缓存，重点清理JS静态资源缓存，很多时候是旧版的可变产品脚本没更新导致的逻辑异常
• 检查JS优化配置：如果你开了JS延迟加载、异步加载、JS合并压缩，把WooCommerce原生的add-to-cart-variation.min.js、jQuery脚本加入白名单，不要对这两个脚本做defer/async处理，必须保证add-to-cart-variation.min.js在jQuery加载完成后按原顺序执行
• 主题兼容校验：临时切换到官方默认Storefront主题测试，如果切主题后错误消失，说明当前使用的主题覆盖的WooCommerce可变产品模板版本过旧、存在逻辑错误。到后台「WooCommerce-状态-模板」页查看过时模板提示，把主题目录下single-product/add-to-cart/路径下的可变产品相关模板替换为当前WooCommerce版本的原生模板，或升级主题到最新兼容版本。

二、排查产品本身配置错误 #

• 打开出问题的可变产品编辑页，进入「属性」设置栏：检查所有用来生成变体的属性，是否都勾选了用于变体选项，漏勾会导致变体选择表单渲染不全
• 进入「变体」设置栏：批量检查所有生成的变体，确保每个有效变体都填写了正常价格、库存状态正常（如果库存为0需要开启“允许缺货下单”才会在前端展示），不要存在草稿状态、无价格的无效变体，无效变体会打断前端属性选择的联动逻辑
• 如果你用了多供应商、会员权限、产品访问限制类插件，检查是否给对应可变产品设置了访问权限，权限拦截时也会抛出这个提示，临时禁用插件即可快速定位。

三、排查插件/自定义代码冲突 #

• 临时禁用除WooCommerce之外的所有插件，刷新产品页测试，如果错误消失，逐个启用插件定位冲突源，这类问题高发于AJAX加购插件、产品快速查看插件、自定义加购按钮插件、批发类插件
• 检查主题functions.php文件或者代码片段插件里，有没有加过挂载到woocommerce_add_to_cart_validation钩子的自定义校验代码，很多二次开发写的校验逻辑没兼容可变产品的参数传递，会误拦截正常请求
• 重置固定链接规则：进入后台「设置-固定链接」，不需要修改原有配置，直接点击“保存更改”刷新路由重写规则，排除自定义产品路由导致的加购表单提交地址异常。

临时兜底方案 #

如果站点急需恢复使用，暂时没定位到根因，可以把下面代码加入主题functions.php文件，临时跳过这个校验拦截：

add_filter( 'woocommerce_add_to_cart_validation', 'custom_skip_variation_check', 999, 3 );
function custom_skip_variation_check( $passed, $product_id, $quantity ) {
    $product = wc_get_product( $product_id );
    if ( $product && $product->is_type( 'variable' ) ) {
        $passed = true;
    }
    return $passed;
}

注意：这只是临时恢复方案，必须找到根因修复，否则可能出现用户未选属性就下单导致的错发、库存异常问题。

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