wp_mail()重复发送相同内容邮件问题及正确调用咨询

我碰到过不少开发者遇到wp_mail能正常发邮件但重复发送的情况，结合你的代码片段，大概率是函数被多次触发调用或者流程里没做重复执行拦截导致的，给你几个实用的解决方向：

一、先确认wp_mail是不是真的被调用了多次 #

先搞清楚问题根源，是函数被调用了多次，还是邮件服务端的问题。你可以在调用wp_mail前后加日志记录，方便排查：

// 获取当前预订号
$operation_number = $_POST['operation_number'];
// 记录调用日志
error_log("准备发送预订{$operation_number}的邮件，当前时间：" . date('Y-m-d H:i:s'));

// 你的wp_mail调用代码
wp_mail($to, $subject, $message, $headers);

// 记录发送完成日志
error_log("预订{$operation_number}的邮件已触发发送，当前时间：" . date('Y-m-d H:i:s'));

然后去wp-content/debug.log（需要先开启WP_DEBUG）里看日志，如果出现多条相同预订号的记录，那就是函数被多次调用了，接下来针对性解决。

二、拦截重复触发的常见方案 #

1. 给邮件发送加「单次触发标记」 #

针对你的预订场景，可以用WordPress的transient临时存储标记，确保同一个预订只发一次邮件：

$operation_number = $_POST['operation_number'];
// 检查该预订是否已经发送过邮件
$mail_sent_flag = get_transient("reservation_mail_{$operation_number}");

if (!$mail_sent_flag) {
    // 执行你的预订确认和数据获取逻辑
    $CLASS->ConfirmReservation($data);
    $info = $CLASS->GetReservationInfo($operation_number)[0];
    
    // 准备邮件参数并发送
    $to = $info['email'];
    $subject = "你的预订确认通知";
    $message = "尊敬的用户，你的预订已确认...";
    $headers = array('Content-Type: text/html; charset=UTF-8');
    
    wp_mail($to, $subject, $message, $headers);
    
    // 设置标记，1小时内不再重复发送（时间可以根据需求调整）
    set_transient("reservation_mail_{$operation_number}", true, 3600);
}

2. 如果是AJAX场景，一定要终止请求 #

如果你的代码是在AJAX回调里执行的，处理完后必须用wp_die()终止进程，否则可能因为请求重复响应导致重复发送：

add_action('wp_ajax_confirm_reservation', 'handle_reservation_confirm');
add_action('wp_ajax_nopriv_confirm_reservation', 'handle_reservation_confirm');

function handle_reservation_confirm() {
    // 验证权限和参数（这步很重要，防止恶意请求）
    if (!isset($_POST['operation_number']) || !wp_verify_nonce($_POST['nonce'], 'reservation_nonce')) {
        wp_die('无效请求');
    }
    
    // 你的预订处理和邮件发送逻辑
    $operation_number = $_POST['operation_number'];
    $mail_sent_flag = get_transient("reservation_mail_{$operation_number}");
    
    if (!$mail_sent_flag) {
        $CLASS->ConfirmReservation($data);
        $info = $CLASS->GetReservationInfo($operation_number)[0];
        wp_mail($info['email'], '预订确认', '内容...');
        set_transient("reservation_mail_{$operation_number}", true, 3600);
    }
    
    // 必须终止AJAX请求
    wp_die();
}

3. 检查是否有重复绑定的钩子 #

如果你的邮件发送逻辑是通过add_action绑定到某个钩子上的，要确保钩子只绑定一次，避免重复触发：

// 先检查是否已经绑定过该动作，避免重复绑定
if (!has_action('woocommerce_order_status_completed', 'send_reservation_mail')) {
    add_action('woocommerce_order_status_completed', 'send_reservation_mail');
}

function send_reservation_mail($order_id) {
    // 邮件发送逻辑
}

4. 排查主题/插件冲突 #

有时候是其他插件或主题的逻辑重复触发了你的邮件发送流程，你可以暂时禁用所有第三方插件，切换到WordPress默认主题（比如Twenty Twenty-Four），测试是否还会重复发送，逐步排查出冲突的插件/主题。

三、额外提醒 #

• 开启WP_DEBUG模式可以帮你快速定位代码里的重复执行问题；
• 表单提交场景一定要加nonce验证，防止恶意重复提交导致的重复发送。

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