本文介绍如何使用 wordpress 钩子在 woocommerce 中仅创建一次指定代码的优惠券，避免重复生成，并提供可复用的健壮实现方案。
本文介绍如何使用 wordpress 钩子在 woocommerce 中仅创建一次指定代码的优惠券，避免重复生成，并提供可复用的健壮实现方案。
在 WooCommerce 开发中，常需通过代码动态创建优惠券（如激活插件时自动添加专属折扣码）。但若直接在 wp_loaded 等高频触发钩子中调用 WC_Coupon::save()，会导致每次页面加载都新建一个同名优惠券——不仅造成数据库冗余，还可能引发优惠叠加、库存误判等业务风险。
根本原因在于：wp_loaded 在每个前端/后台请求中均执行，而原始代码未做存在性校验。正确做法是先检查优惠券是否已存在，仅当不存在时才创建。WooCommerce 提供了内置函数 wc_get_coupon_id_by_code()，它根据优惠券代码返回对应 ID（存在则返回整数 ID，不存在则返回 false），是判断唯一性的可靠依据。
以下是推荐的完整实现：
function create_single_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->set_date_created( current_time( 'mysql' ) );
try {
$coupon->save();
// 可选：记录日志或触发通知
error_log( "Coupon '{$coupon_code}' created successfully." );
} catch ( Exception $e ) {
error_log( "Failed to create coupon '{$coupon_code}': " . $e->getMessage() );
}
}
}
add_action( 'wp_loaded', 'create_single_coupon' );⚠️ 重要注意事项：
-
钩子选择建议：
wp_loaded虽可用，但更稳妥的做法是将创建逻辑移至插件激活钩子（如register_activation_hook），确保仅在插件启用时执行一次； -
代码唯一性：WooCommerce 默认对优惠券代码强制唯一（数据库
post_name字段有唯一索引），但依赖wc_get_coupon_id_by_code()校验仍是最佳实践； -
权限与时机：确保执行时 WooCommerce 已完全加载（
wc_get_coupon_id_by_code在woocommerce_init之后才可用），若遇“函数未定义”错误，请改用'woocommerce_init'钩子； - 批量场景优化：若需创建多个优惠券，应统一查询所有待建代码的存在状态，再批量插入，避免多次数据库查询。
综上，通过存在性校验 + 显式错误处理 + 合理钩子选择，即可安全、高效地实现“只创建一次”的优惠券初始化需求。
