Woocommerce程序创建订单未触发确认邮件问题求助

你遇到的核心问题是：通过插件创建的WooCommerce订单，无论代码修改状态还是后台手动修改，都无法触发客户确认/下载邮件，但无插件的生产环境正常。这说明问题出在订单创建的流程缺失关键数据或未触发WooCommerce的邮件钩子。

以下是针对性的解决方向：

1. 补充订单必填基础字段 #

WooCommerce发送邮件依赖订单的核心元数据，仅设置billing_email不足以触发完整的邮件逻辑。需补充至少以下字段：

function ode_cd_create_order($code, $email) {
    $product_id = get_product_id_by_unique_code($code);
    $product = wc_get_product($product_id);

    // 创建订单时指定访客用户ID（0代表未注册用户）
    $order = wc_create_order(array('customer_id' => 0));
    
    $order->add_product($product, 1);
    
    // 补充账单基础信息（可设为匿名或从邮箱提取前缀）
    $order->set_billing_email($email);
    $order->set_billing_first_name('Guest');
    $order->set_billing_last_name('User');
    $order->set_billing_country('FR'); // 根据你的站点设置调整
    
    // 因为是代码兑换，设置订单总额为0
    $order->set_total(0);
    
    // 设置付款方式（标记为已付款）
    $order->set_payment_method('code_redemption');
    $order->set_payment_method_title('Code Validation');
    $order->set_date_paid(current_time('mysql'));
    
    // 用update_status触发状态变更钩子，第三个参数true强制发送邮件
    $order->update_status('completed', 'Code validated successfully', true);
}

2. 确保使用正确的状态更新方法 #

• set_status()仅修改订单状态值，不会触发任何WooCommerce钩子（包括邮件发送的钩子），必须使用update_status()。
• update_status()的第三个参数$send_notifications默认是true，但明确指定可以避免环境差异导致的问题。

3. 手动触发下载邮件（兜底方案） #

如果上述调整后仍不触发邮件，可以直接调用WooCommerce的邮件类手动发送：

// 在update_status之后添加
$mailer = WC()->mailer();
$completed_order_email = $mailer->get_emails()['WC_Email_Customer_Completed_Order'];
if ($completed_order_email) {
    $completed_order_email->trigger($order->get_id());
}

4. 排查钩子禁用与日志 #

• 检查插件代码中是否存在remove_action或remove_filter禁用了WooCommerce的邮件钩子，比如woocommerce_order_status_completed_notification。
• 开启WooCommerce日志（WooCommerce > 状态 > 日志），查看woocommerce-logs下的邮件相关日志，排查是否有发送失败的错误信息（比如邮件服务器配置、字段缺失报错）。

5. 后台手动修改无效的原因 #

如果后台手动修改状态也不发邮件，说明订单本身的元数据存在缺失，导致WooCommerce认为该订单不符合邮件发送条件（比如缺少付款记录、客户信息不完整）。按照第1点补充字段后，后台修改状态应该能正常触发邮件。

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