本文介绍两种专业方案：一是通过条件判断避免在结账页触发重量提醒；二是将提示升级为错误并禁用“去结算”按钮，强制用户达标后才能进入结账流程。
本文介绍两种专业方案：一是通过条件判断避免在结账页触发重量提醒；二是将提示升级为错误并禁用“去结算”按钮，强制用户达标后才能进入结账流程。
在 WooCommerce 中，使用 woocommerce_check_cart_items 钩子添加购物车重量校验（如要求订单总重 ≥1kg）非常常见。但若仅简单添加通知（wc_add_notice()），该通知会持续保留在后续页面（包括结账页），影响用户体验，甚至造成逻辑误导——用户已进入结账流程，却仍看到“请再加购”的提示。
✅ 推荐方案一：智能跳过结账页通知（推荐首选）
核心思路是仅在购物车页生效校验逻辑，在结账页主动退出函数执行，避免冗余提示：
add_action('woocommerce_check_cart_items', 'check_cart_minweight_for_cart_only', 10);
function check_cart_minweight_for_cart_only() {
// ✅ 关键防护：不在结账页执行
if (is_checkout()) {
return;
}
$total_weight = WC()->cart->get_cart_contents_weight();
if ($total_weight < 1) {
wc_add_notice(
sprintf(
__('您当前选购商品总重 %.2f Kg，请继续加购。订单满 1kg 即享免运费！', 'woocommerce'),
$total_weight
),
'notice' // 使用 'notice' 而非 'success'，语义更准确
);
}
}? 提示：is_checkout() 是 WooCommerce 内置条件函数，安全可靠；get_cart_contents_weight() 替代已弃用的 $woocommerce->cart->cart_contents_weight，兼容性更好；%.2f 格式化输出提升数值可读性。
✅ 推荐方案二：强化校验 + 阻断结账入口（适用于强业务约束）
若业务上必须确保用户达到最低重量才允许结账（例如物流成本敏感场景），可将提示设为 'error' 并移除结账按钮：
add_action('woocommerce_check_cart_items', 'enforce_min_weight_before_checkout', 10);
function enforce_min_weight_before_checkout() {
$total_weight = WC()->cart->get_cart_contents_weight();
if ($total_weight < 1) {
wc_add_notice(
sprintf(
__('订单未达免运费门槛（需 ≥1kg），当前仅 %.2f Kg。请继续加购。', 'woocommerce'),
$total_weight
),
'error'
);
// ? 移除默认“去结算”按钮（仅影响前端渲染）
remove_action('woocommerce_proceed_to_checkout', 'woocommerce_button_proceed_to_checkout', 20);
// ✅ 可选：补充自定义提示文案增强引导
add_action('woocommerce_proceed_to_checkout', 'display_weight_requirement_hint', 10);
}
}
function display_weight_requirement_hint() {
echo '<p class="woocommerce-info" style="margin-top: 1em; font-weight: 600;">⚠️ 满 1kg 才能结算 —— 当前重量不足</p>';
}⚠️ 注意事项与最佳实践
- 不要使用 'success' 类型通知展示限制性信息，易引发用户困惑；优先选用 'notice'（中性提示）或 'error'（阻断性校验）；
- 若启用方案二，请同步检查主题或插件是否自定义了结账入口（如 AJAX 结算按钮），必要时补充 JavaScript 层校验；
- 建议在 functions.php 中添加代码后，清空 WooCommerce 缓存及对象缓存（如有），并测试不同设备端表现；
- 长期维护建议封装为独立插件，避免主题更新导致逻辑丢失。
两种方案可根据业务强度灵活选择：轻量引导用方案一，强规则管控用方案二。二者均彻底解决“结账页残留通知”问题，同时提升用户路径清晰度与转化体验。
