本文详解如何在用户访问 woocommerce 结账页面且购物车非空时，精准、单次触发个性化邮件通知，避免因钩子误用或条件判断缺失导致的重复发送问题，并提供兼容 woocommerce 邮件模板风格的进阶方案。
在 WooCommerce 开发中，为提升转化率与用户体验，常需在用户进入结账流程的关键节点（如 checkout 页面）主动推送提示类邮件——例如“您的订单即将完成，请确认信息”等轻量级提醒。但许多开发者误用 woocommerce_after_shop_loop_item 等商品列表页钩子，导致邮件在首页、分类页甚至 AJAX 刷新时被反复触发，造成严重逻辑错误与用户骚扰。
核心问题在于钩子选择与执行时机控制：
- ❌ 错误钩子：woocommerce_after_shop_loop_item 仅作用于商品循环内（如商店页、搜索页），与结账流程完全无关；
- ✅ 正确钩子：woocommerce_before_checkout_form 是 WooCommerce 官方推荐的、仅在结账表单渲染前执行一次的安全入口点，天然满足“仅在 checkout 页面触发”的前提。
此外，直接调用 WC()->cart 前未校验其可用性，可能在某些上下文（如 REST API 请求、后台进程）中引发 PHP Notice 或 Fatal Error。因此，健壮的实现必须包含三层防护：
- 用户登录状态检查（is_user_logged_in()）；
- WC Cart 实例存在性验证（WC()->cart !== null）；
- 购物车内容与用户字段有效性校验（邮箱与姓名非空）。
以下是经过生产环境验证的标准实现代码：
function send_checkout_greeting_email() {
// 仅对已登录用户执行
if ( ! is_user_logged_in() ) {
return;
}
// 确保 WooCommerce 购物车实例已初始化（避免未加载 WC 的上下文报错）
if ( ! WC()->cart instanceof WC_Cart ) {
return;
}
// 仅当购物车非空时发送
if ( WC()->cart->is_empty() ) {
return;
}
$current_user = wp_get_current_user();
$email = $current_user->user_email;
$name = $current_user->user_firstname;
// 关键：双重非空校验，防止空字符串或 null 导致 wp_mail 失败
if ( empty( $email ) || empty( $name ) ) {
return;
}
$to = $email;
$subject = sprintf( __( 'Hello %s, your purchase is almost ready!', 'woocommerce' ), esc_html( $name ) );
$body = sprintf(
__( '<p>Hi %s,<br><br>Your cart contains %d item(s). Proceed to checkout to complete your order.</p>', 'woocommerce' ),
esc_html( $name ),
WC()->cart->get_cart_contents_count()
);
$headers = array( 'Content-Type: text/html; charset=UTF-8' );
// 使用 WordPress 原生邮件函数，确保兼容性
wp_mail( $to, $subject, $body, $headers );
}
add_action( 'woocommerce_before_checkout_form', 'send_checkout_greeting_email' );⚠️ 重要注意事项： 该钩子在每次结账页加载时触发（含刷新），但因 wp_mail() 是同步阻塞操作，不会影响页面渲染性能；若需更高可靠性（如防止网络延迟失败），建议结合 WP-Cron 异步队列或第三方邮件服务（如 SendGrid）； 若希望邮件样式与 WooCommerce 默认通知（如订单确认邮件）完全一致，可改用 WC_Email 系统封装：$mailer = WC()->mailer(); $message = $mailer->wrap_message( sprintf( __( 'Hello %s', 'woocommerce' ), esc_html( $name ) ), __( 'Your checkout reminder content here.', 'woocommerce' ) ); $mailer->send( $to, $subject, $message, 'Content-Type: text/html' );
最后，请务必在子主题的 functions.php 中添加此代码，并在上线前通过真实用户会话测试：清空购物车 → 添加商品 → 访问 /checkout/ → 检查收件箱是否仅收到 1 封邮件。切勿在生产环境直接使用未经验证的钩子或跳过空值校验——这是 WooCommerce 邮件自动化中最常见的稳定性陷阱。
