自定义WooCommerce优惠券验证函数未触发，如何排查？

以下是几个常见原因及对应的排查方向：

1. 错误使用add_action而非add_filter #

woocommerce_coupon_is_valid是过滤器钩子，不是动作钩子。如果代码里用了add_action绑定函数，肯定不会触发，必须用add_filter，同时要注意参数数量：

add_filter('woocommerce_coupon_is_valid', 'check_coupon_code', 10, 2);

第四个参数2表示函数接受2个参数（$is_valid和$coupon），如果你的函数需要用到这两个参数，必须声明正确的参数数量。

2. 钩子注册时机不对 #

如果钩子注册代码放在WooCommerce初始化之前（比如直接写在插件主文件顶部），会导致绑定失败。正确做法是在WooCommerce加载完成后注册：

add_action('woocommerce_init', function() {
    add_filter('woocommerce_coupon_is_valid', 'check_coupon_code', 10, 2);
});

也可以在插件主文件头部添加Requires Plugins: woocommerce，确保插件在WooCommerce之后加载。

3. 优惠券已被基础验证标记为无效 #

WooCommerce触发woocommerce_coupon_is_valid前，会先做基础验证（比如是否过期、是否达使用上限、是否匹配当前商品等）。如果基础验证已判定优惠券无效，这个钩子就不会再执行。

可以先测试一张完全符合基础条件的优惠券（未过期、未达使用次数、适用于购物车商品），看函数是否触发。

4. 钩子名称或函数名拼写错误 #

检查代码里的钩子名称是否准确，比如有没有写成woocommerce_coupon_valid（少了is）、woocommerce_coupon_isvalide（拼写错误），或者函数名和绑定的名称不一致。

5. 函数内部存在致命错误 #

即便其他日志正常，如果check_coupon_code函数有语法错误或致命错误，会直接中断执行，导致error_log无法输出。可以先简化函数做测试：

function check_coupon_code($is_valid, $coupon) {
    error_log('check_coupon_code已触发，优惠券码：' . $coupon->get_code());
    return $is_valid;
}

确认触发后再逐步添加原有逻辑排查问题。

6. 优先级被其他插件/主题覆盖 #

如果有其他插件或主题也使用了这个钩子，且设置了更高优先级（比如数值比10小，或更大数值但返回false终止过滤器链），可能会导致你的函数无法执行。可以尝试调整优先级：

// 提高优先级，确保先执行
add_filter('woocommerce_coupon_is_valid', 'check_coupon_code', 1, 2);
// 或设置为高数值，确保最后执行
add_filter('woocommerce_coupon_is_valid', 'check_coupon_code', 999, 2);

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