本文介绍如何使用 wordpress 钩子安全、可靠地在 woocommerce 中创建单个唯一优惠券，避免重复生成，并提供可直接复用的代码实现与关键注意事项。
本文介绍如何使用 wordpress 钩子安全、可靠地在 woocommerce 中创建单个唯一优惠券，避免重复生成，并提供可直接复用的代码实现与关键注意事项。
在 WooCommerce 开发中，通过 wp_loaded 等早期钩子动态创建优惠券看似简单，但若缺乏存在性校验，极易导致每次请求都新建同名优惠券——不仅造成数据库冗余，还可能引发折扣冲突或管理混乱。核心问题在于：原始代码未检查 'customcode' 是否已存在，便直接实例化并保存新优惠券。
✅ 正确做法是：先查询再创建。WooCommerce 提供了内置函数 wc_get_coupon_id_by_code( $code )，它会返回匹配优惠券的 ID（整数），若不存在则返回 false。利用该返回值进行条件判断，即可确保仅在优惠券尚未存在时执行创建逻辑。
以下是经过验证的完整解决方案：
function create_coupon() {
$coupon_code = 'customcode';
// 检查优惠券是否已存在（推荐方式）
if ( ! wc_get_coupon_id_by_code( $coupon_code ) ) {
$coupon = new WC_Coupon();
$coupon->set_code( $coupon_code );
$coupon->set_amount( 300 );
$coupon->set_discount_type( 'fixed_cart' ); // 可选：明确指定折扣类型（默认即此）
$coupon->set_usage_limit( 1 ); // 可选：限制总使用次数
$coupon->set_individual_use( true ); // 可选：设为仅限单独使用
$coupon->save();
// （调试用）可记录日志确认创建成功
error_log( "Coupon '{$coupon_code}' created successfully." );
}
}
add_action( 'wp_loaded', 'create_coupon' );
⚠️ 重要注意事项：
-
wp_loaded钩子虽早，但会在每次前端/后台请求时触发，因此必须依赖存在性检查，不可省略； - 若需更严格的“一次性”保障（如仅在插件激活时运行），应改用
register_activation_hook，配合update_option()标记状态； - 建议显式设置
set_discount_type()和set_usage_limit()等关键属性，避免依赖默认值带来的不确定性； - 创建后可通过 WooCommerce 后台「营销 → 优惠券」页面验证是否仅存在一条
customcode记录； - 生产环境建议添加错误处理（如捕获
WC_Data_Exception），提升健壮性。
通过这一模式，你既能利用钩子实现自动化初始化，又能确保数据唯一性与系统稳定性。
