WooCommerce限制优惠券对应用户角色后修改报错提示不生效怎么办

问题原因 #

• 错误码匹配错误：官方文档中标注的错误码100对应WooCommerce原生的「优惠券不存在/无效」错误，你自定义实现的「用户角色不符合优惠券使用权限」的错误逻辑，并未使用100作为错误码，因此你写的拦截逻辑无法触发。
• 钩子优先级不足：如果你实现角色限制逻辑时使用的woocommerce_coupon_error钩子优先级高于你当前修改代码的10优先级，你的修改结果会被原有逻辑覆盖。
• 缓存未清空：WooCommerce会缓存优惠券相关的校验逻辑，未清空缓存的情况下修改后的代码不会立即生效。

修复方案 #

方案1：匹配自定义错误码 #

你可以先查看自己实现角色限制逻辑的代码，找到抛出错误时传入的错误码，将原代码中的case 100替换为对应的错误码即可。

方案2：匹配错误文本关键词（更通用） #

如果找不到对应的自定义错误码，可以直接通过错误文本关键词匹配修改，避免错误码匹配失效的问题，代码如下：

add_filter( 'woocommerce_coupon_error','coupon_error_message_change', 999, 3 );
function coupon_error_message_change( $err, $err_code, $parm ) {
    // 匹配角色权限相关的错误提示关键词，避免误改其他优惠券错误
    if ( strpos( $err, 'not valid with your customer role' ) !== false ) {
        $err = sprintf( __( '抱歉，优惠券代码 "%s" 无效。', 'woocommerce' ), $parm->get_code() );
    }
    return $err;
}

注意事项 #

• 代码需要放在子主题的functions.php文件、或自定义功能插件中，禁止直接修改父主题、WooCommerce核心文件，避免版本更新后代码被覆盖。
• 修改完成后需要清空网站缓存、WooCommerce缓存、浏览器缓存，建议使用隐身窗口测试效果。
• 如果你是使用第三方插件实现的优惠券角色限制功能，需要查找对应插件提供的错误修改钩子，以上代码仅适用于自定义代码、WooCommerce原生扩展实现的限制逻辑。

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